Szűrés X-fiókok alapján
Ezen az oldalon
Konkrét fiókok célzása az X-en
Ahogy a Webes keresés lehetővé teszi a szűrést domainek alapján, az X-keresés fiókok (felhasználónevek) szerint is szűr. Korlátozhatod a keresést meghatározott fiókok bejegyzéseire, vagy kizárhatsz bizonyos fiókokat az eredményekből. Ez a szűrés elengedhetetlen olyan esetekben, mint a monitorozás, a márkafigyelés vagy az influensz-elemzés.
A két szűrőparaméter
Az X-keresés két felhasználónév-szűrő paramétert kínál:
allowed_x_handles: a keresést a felsorolt fiókok bejegyzéseire korlátozza (engedélyezési lista)excluded_x_handles: kizárja a felsorolt fiókok bejegyzéseit (tiltólista)
A Webes kereséshez hasonlóan ezek a paraméterek kölcsönösen kizárják egymást. Nem használhatod mindkettőt ugyanabban a kérésben.
Mindkét paraméter legfeljebb 10 felhasználónevet fogad el tömbként (szemben a Webes keresés 5 domainjével).
Az allowed_x_handles (engedélyezési lista) használata
Ez a paraméter ideális konkrét fiókok kommunikációjának monitorozására:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest announcements from xAI?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"]
}]
)
A modell csak ezeken a fiókokon keresztül közzétett bejegyzéseket keres.
Az engedélyezési lista alkalmazási esetei
- Versenytárs-elemzés: figyeld a versenytársaid bejelentéseit
- Márkafigyelés: kövesd nyomon a hivatalos fiókjaidat és nagyköveteidét
- Influensz-elemzés: gyűjtsd össze egy szakértői panel véleményeit
- Intézményi követés: figyeld a szabályozó szervek vagy hivatalos szervezetek fiókjait
Az excluded_x_handles (tiltólista) használata
Ezzel a paraméterrel kizárhatsz bizonyos fiókokat, például botokat vagy irreleváns felhasználókat:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What do developers think about the latest version of Python?",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_python_news", "spam_account"]
}]
)
A tiltólista alkalmazási esetei
- Botok kizárása: távolítsd el az automatizált fiókokat az eredményekből
- Spam szűrése: szűrd ki az alacsony minőségű tartalmairól ismert fiókokat
- Saját fiókok kizárása: elemezd a külső reakciókat a saját bejegyzéseid nélkül
SDK szintaxis
xAI SDK (Python)
from xai_sdk.tools import x_search
tools=[x_search(
allowed_x_handles=["elonmusk", "xaboratory"]
)]
OpenAI SDK (Python)
tools=[{
"type": "x_search",
"allowed_x_handles": ["elonmusk", "xaboratory"]
}]
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk", "xaboratory"]
})]
Figyeld meg a camelCase konvenciót a JavaScript SDK-ban: allowedXHandles az allowed_x_handles helyett.
Legjobb gyakorlatok
Választás az engedélyezési és a tiltólista között
Használd az engedélyezési listát, ha van egy meghatározott fiókkészleted, és csak az ő bejegyzéseiket szeretnéd. Ez a legpontosabb és token-hatékonyabb módszer.
Használd a tiltólistát, ha széles körű keresést szeretnél végezni, de meg kell tisztítanod az eredményeket az ismert zajforrások kiszűrésével.
A felhasználónevek számának optimalizálása
Mivel a limit 10 felhasználónév, légy válogatós. Ha 10-nél több fiókot kell monitoroznod, csoportosítsd a kéréseidet téma szerint, vagy végezz több szekvenciális hívást.
Felhasználónév formátuma
A felhasználónevek nem tartalmazzák a @ jelet (például: xaboratory). Ellenőrizd, hogy a felhasználónevek helyesek-e; egy elgépelés esetén az adott fiókra egyszerűen nem kapnál találatot.
Főbb megállapítások
- Két paraméter:
allowed_x_handles(engedélyezési lista) ésexcluded_x_handles(tiltólista) - Kölcsönösen kizárják egymást: kérésenként csak az egyik használható
- Paraméterenként maximum 10 felhasználónév
- A felhasználóneveket a
@jel nélkül kell megadni:"elonmusk", nem pedig"@elonmusk" - Ideális monitorozáshoz, márkafigyeléshez és influensz-elemzéshez