Filtriranje po uporabniških imenih in datumih na X
Na tej strani
Natančno ciljanje iskanj na X
Iskanje po X prinaša resnično vrednost šele, ko obvladaš njegove parametre za filtriranje. Namesto da bi pridobil surov vir objav, lahko ciljaš na določene račune, nastaviš natančna časovna okna in izključiš vire šuma. Ti filtri spremenijo splošno orodje za iskanje v natančen instrument za spremljanje.
Filtriranje po uporabniških imenih: allowed_x_handles in excluded_x_handles
Spremljanje določenih računov
Parameter allowed_x_handles omeji iskanje na objave, ki so jih objavili računi, ki jih navedeš. Hkrati lahko ciljaš na največ 10 uporabniških imen:
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"
]
}]
)
Izključevanje hrupnih računov
Parameter excluded_x_handles deluje obratno. Dovoljuje vse račune razen tistih, ki jih določiš. Uporabno je za odpravo botov ali računov z nepomembno vsebino:
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"]
}]
)
Pravilo medsebojne izključnosti
Tako kot pri spletnih domenah sta allowed_x_handles in excluded_x_handles medsebojno izključujoča. Ne moreš ju združiti v enem samem klicu. Omejitev je 10 uporabniških imen na parameter, kar je dvakrat več kot omejitev za spletne domene.
Filtriranje po datumih: from_date in to_date
Časovni parametri ti omogočajo definiranje natančnega iskalnega okna v formatu ISO 8601 (LLLL-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"
}]
)
Ti filtri so še posebej uporabni za:
- Analizo vpliva dogodka: določi obdobje okoli dogodka
- Primerjavo sentimenta pred/po: izvedi dva poizvedba z različnimi okni
- Izogibanje staremu šumu: osredotoči se na nedavne razprave
Uporaba z izvornim Python SDK
xAI SDK poleg nizov ISO sprejema tudi Pythonove objekte datetime:
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)
)]
)
Konvencija camelCase v JavaScriptu
Vercel AI SDK za imena parametrov uporablja konvencijo camelCase:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Združevanje filtrov
Za največjo natančnost lahko v enem klicu združiš uporabniška imena in datume:
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"
}]
)
Izgradnja dinamičnega sistema za spremljanje
S programskim združevanjem teh filtrov lahko zgradiš konfigurabilno orodje za spremljanje:
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")
}
# Monitor AI leaders for the week
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Vaja
Konfiguriraj ciljno iskanje po X za 3 do 5 vplivnih računov v tvojem sektorju. Nastavi tedensko časovno okno in primerjaj rezultate z iskanjem brez filtrov uporabniških imen. Izmeri razliko v ustreznosti.
Ključne ugotovitve
allowed_x_handlesinexcluded_x_handlesfiltrirata po računu (največ 10 na parameter)- Oba parametra za uporabniška imena sta medsebojno izključujoča
from_dateinto_datedoločata časovno okno v formatuLLLL-MM-DD- Datume je mogoče kombinirati s filtri uporabniških imen
- Python SDK sprejema objekte
datetime, JavaScript SDK pa uporablja camelCase - Ti filtri spremenijo iskanje po X iz splošnega orodja v ciljni instrument za spremljanje