Filtrovanie podľa používateľských mien a dátumov na X
Na tejto strane
Presné cielenie vyhľadávania na X
Vyhľadávanie na X prináša skutočnú hodnotu až vtedy, keď zvládneš jeho filtre. Namiesto získavania surového toku príspevkov môžeš cieliť na konkrétne účty, nastaviť presné časové okná a vylúčiť zdroje šumu. Tieto filtre menia všeobecný vyhľadávací nástroj na precízny monitorovací systém.
Filtrovanie podľa používateľských mien: allowed_x_handles a excluded_x_handles
Monitorovanie konkrétnych účtov
Parameter allowed_x_handles obmedzuje vyhľadávanie na príspevky zverejnené účtami, ktoré uvedieš. Môžeš cieliť až na 10 používateľských mien súčasne:
response = client.responses.create(
model="grok-4.5",
input="Summary of recent announcements from these tech accounts",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"elonmusk",
"sama",
"demishassabis",
"ylecun"
]
}]
)
Vylúčenie rušivých účtov
Parameter excluded_x_handles funguje opačne. Umožňuje vyhľadávať na všetkých účtoch okrem tých, ktoré špecifikuješ. Je užitočný na elimináciu botov alebo účtov s irelevantným obsahom:
response = client.responses.create(
model="grok-4.5",
input="Serious discussions on AI regulation",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_spam_1", "compte_parodie"]
}]
)
Pravidlo vzájomnej výlučnosti
Rovnako ako pri webových doménach, parametre allowed_x_handles a excluded_x_handles sú vzájomne výlučné. Nemôžeš ich kombinovať v rámci jedného volania. Limit je 10 používateľských mien na parameter, čo je dvojnásobok limitu pre webové domény.
Filtrovanie podľa dátumov: from_date a to_date
Časové parametre ti umožňujú definovať presné okno vyhľadávania vo formáte ISO 8601 (RRRR-MM-DD):
response = client.responses.create(
model="grok-4.5",
input="Reactions to the Grok 4.5 announcement",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-15"
}]
)
Tieto filtre sú obzvlášť užitočné pre:
- Analýzu dopadu udalosti: definuj obdobie okolo udalosti
- Porovnanie sentimentu pred/po: spusti dva dotazy s rôznymi oknami
- Vyhnutie sa starému šumu: zameraj sa na nedávne diskusie
Použitie s natívnym Python SDK
xAI SDK akceptuje okrem reťazcov ISO aj objekty datetime z Pythonu:
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)
)]
)
Konvencia camelCase v JavaScripte
Vercel AI SDK používa pre názvy parametrov konvenciu camelCase:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Kombinovanie filtrov
Pre maximálnu presnosť môžeš v rámci jedného volania kombinovať používateľské mená aj dátumy:
response = client.responses.create(
model="grok-4.5",
input="What did Sam Altman say about GPT-5 in March 2026?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["sama"],
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Budovanie dynamického monitorovacieho systému
Programatickým kombinovaním týchto filtrov môžeš vytvoriť konfigurovateľný monitorovací nástroj:
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")
}
# Monitorovanie lídrov v AI za posledný týždeň
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Precvičovanie
Nakonfiguruj cielené vyhľadávanie na X pre 3 až 5 vplyvných účtov vo tvojom odvetví. Nastav časové okno na jeden týždeň a porovnajte výsledky s vyhľadávaním bez filtrov podľa používateľských mien. Zmeraj rozdiel v relevantnosti.
Kľúčové poznatky
allowed_x_handlesaexcluded_x_handlesfiltrujú podľa účtu (maximálne 10 pre každý)- Oba parametre pre používateľské mená sú vzájomne výlučné
from_dateato_datedefinujú časové okno vo formáteRRRR-MM-DD- Dátumy je možné kombinovať s filtrami podľa používateľských mien
- Python SDK akceptuje objekty
datetime, JavaScript SDK používa camelCase - Tieto filtre menia vyhľadávanie na X zo všeobecného nástroja na cielený monitorovací systém