Filtrar por identificadores y fechas en X
En esta página
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_handlesyexcluded_x_handlesfiltran por cuenta (10 como máximo cada uno)- Ambos parámetros de identificadores son mutuamente excluyentes
from_dateyto_datedefinen la ventana de tiempo en formatoAAAA-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