Ir al contenido principal
Español— Elegir un idioma
Menú

Filtrar por identificadores y fechas en X

Lección 6 de 14 Actualizado el 30 de julio de 2026 Principiante
En esta página
  1. Precisa tus búsquedas en X
  2. Filtrar por identificadores: allowed_x_handles y excluded_x_handles
  3. Filtrar por fechas: from_date y to_date
  4. Combinar filtros
  5. Construir un sistema de monitorización dinámico
  6. Práctica
  7. Puntos clave

Precisa tus búsquedas en X

La búsqueda en X ofrece un valor real cuando dominas sus parámetros de filtrado. En lugar de obtener un flujo bruto de publicaciones, puedes dirigirte a cuentas específicas, establecer ventanas de tiempo precisas y excluir fuentes de ruido. Estos filtros transforman una herramienta de búsqueda de propósito general en un instrumento de monitorización de precisión.

Filtrar por identificadores: allowed_x_handles y excluded_x_handles

Monitorizar cuentas específicas

El parámetro allowed_x_handles restringe la búsqueda a las publicaciones publicadas por las cuentas que indiques. Puedes seleccionar hasta 10 identificadores simultáneamente:

response = client.responses.create(
    model="grok-4.5",
    input="Resumen de los anuncios recientes de estas cuentas tecnológicas",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "elonmusk",
            "sama",
            "demishassabis",
            "ylecun"
        ]
    }]
)

Excluir cuentas ruidosas

El parámetro excluded_x_handles funciona a la inversa. Permite todas las cuentas excepto las que especifiques. Resulta útil para eliminar bots o cuentas con contenido irrelevante:

response = client.responses.create(
    model="grok-4.5",
    input="Debates serios sobre la regulación de la IA",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_spam_1", "compte_parodie"]
    }]
)

Regla de exclusión mutua

Al igual que con los dominios web, allowed_x_handles y excluded_x_handles son mutuamente excluyentes. No puedes combinarlos en una única llamada. El límite es de 10 identificadores por parámetro, el doble del límite para dominios web.

Filtrar por fechas: from_date y to_date

Los parámetros de tiempo te permiten definir una ventana de búsqueda precisa en formato ISO 8601 (AAAA-MM-DD):

response = client.responses.create(
    model="grok-4.5",
    input="Reacciones al anuncio de Grok 4.5",
    tools=[{
        "type": "x_search",
        "from_date": "2026-03-01",
        "to_date": "2026-03-15"
    }]
)

Estos filtros son especialmente útiles para:

  • Analizar el impacto de un evento: define el periodo alrededor del suceso
  • Comparar el sentimiento antes/después: ejecuta dos consultas con ventanas distintas
  • Evitar ruido antiguo: céntrate en debates recientes

Uso con el SDK nativo de Python

El SDK de xAI acepta objetos datetime de Python además de cadenas ISO:

from xai_sdk.tools import x_search
from datetime import datetime

response = client.chat.create(
    model="grok-4.5",
    tools=[x_search(
        from_date=datetime(2026, 3, 1),
        to_date=datetime(2026, 3, 31)
    )]
)

Convención camelCase en JavaScript

El SDK de Vercel AI utiliza la convención camelCase para los nombres de los parámetros:

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk"],
  fromDate: "2026-03-01",
  toDate: "2026-03-31"
})]

Combinar filtros

Puedes combinar identificadores y fechas en una única llamada para lograr la máxima precisión:

response = client.responses.create(
    model="grok-4.5",
    input="¿Qué dijo Sam Altman sobre GPT-5 en marzo de 2026?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["sama"],
        "from_date": "2026-03-01",
        "to_date": "2026-03-31"
    }]
)

Construir un sistema de monitorización dinámico

Combinando estos filtros mediante programación, puedes crear una herramienta de monitorización configurable:

def create_x_monitor(handles, days_back=7):
    from datetime import datetime, timedelta
    today = datetime.now()
    start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")

    return {
        "type": "x_search",
        "allowed_x_handles": handles,
        "from_date": start,
        "to_date": today.strftime("%Y-%m-%d")
    }

# Monitorizar a líderes de la IA durante la semana
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Práctica

Configura una búsqueda dirigida en X para entre 3 y 5 cuentas influyentes de tu sector. Establece una ventana de tiempo de una semana y compara los resultados con una búsqueda sin filtros de identificadores. Mide la diferencia en relevancia.

Puntos clave

  • allowed_x_handles y excluded_x_handles filtran por cuenta (10 como máximo cada uno)
  • Ambos parámetros de identificadores son mutuamente excluyentes
  • from_date y to_date definen la ventana de tiempo en formato AAAA-MM-DD
  • Las fechas se pueden combinar con filtros de identificadores
  • El SDK de Python acepta objetos datetime; el SDK de JavaScript usa camelCase
  • Estos filtros transforman la búsqueda en X de una herramienta de propósito general en un instrumento de monitorización dirigido