Filtrowanie po kontach na X
Na tej stronie
Targetowanie konkretnych kont na X
Podobnie jak Wyszukiwarka internetowa pozwala filtrować wyniki po domenach, Wyszukiwarka X umożliwia filtrowanie po kontach (nazwach użytkownika). Możesz ograniczyć wyszukiwanie do postów opublikowanych przez określony zestaw kont lub wykluczyć niektóre konta z wyników. To filtrowanie jest kluczowe w przypadkach takich jak monitoring, śledzenie marki czy analiza influencerów.
Dwa parametry filtrowania
Wyszukiwarka X oferuje dwa parametry filtrowania po kontach:
allowed_x_handles: ogranicza wyszukiwanie do postów pochodzących z wymienionych kont (biała lista)excluded_x_handles: wyklucza posty z wymienionych kont (czarna lista)
Podobnie jak w przypadku Wyszukiwarki internetowej, parametry te są wzajemnie wykluczające się. Nie możesz użyć obu w tym samym żądaniu.
Każdy parametr przyjmuje tablicę zawierającą do 10 nazw użytkownika (w porównaniu do 5 domen dla Wyszukiwarki internetowej).
Używanie allowed_x_handles (biała lista)
Ten parametr jest idealny do monitorowania komunikacji pochodzącej od konkretnych kont:
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"]
}]
)
Model przeszuka wyłącznie posty opublikowane przez te konta.
Przypadki użycia białej listy
- Wywiad konkurencyjny: monitoruj ogłoszenia swoich konkurentów
- Monitoring marki: śledź swoje oficjalne konta oraz konta ambasadorów
- Analiza influencerów: agreguj opinie grupy ekspertów
- Śledzenie instytucjonalne: obserwuj konta regulatorów lub oficjalnych organizacji
Używanie excluded_x_handles (czarna lista)
Ten parametr pozwala wykluczyć określone konta, takie jak boty lub konta nieistotne:
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"]
}]
)
Przypadki użycia czarnej listy
- Wykluczanie botów: usuń z wyników konta zautomatyzowane
- Wykluczanie spamu: odfiltruj konta znane z publikowania treści niskiej jakości
- Wykluczanie własnych kont: analizuj reakcje zewnętrzne bez uwzględniania własnych postów
Składnia SDK
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"]
})]
Zwróć uwagę na konwencję camelCase w SDK JavaScript: allowedXHandles zamiast allowed_x_handles.
Najlepsze praktyki
Wybór między białą a czarną listą
Użyj białej listy, gdy masz zdefiniowany zestaw kont i chcesz uzyskać tylko ich posty. Jest to metoda najbardziej precyzyjna i najbardziej oszczędzająca tokeny.
Użyj czarnej listy, gdy chcesz przeprowadzić szerokie wyszukiwanie, ale musisz je oczyścić, eliminując znane źródła szumu.
Optymalizacja liczby kont
Przy limicie 10 kont bądź selektywny. Jeśli musisz monitorować więcej niż 10 kont, pogrupuj żądania według tematu lub wykonaj wiele wywołań sekwencyjnych.
Format nazwy użytkownika
Nazwy użytkownika nie zawierają symbolu @ (na przykład xaboratory). Upewnij się, że nazwy są poprawne – literówka w nazwie spowoduje po prostu brak wyników dla tego konta.
Kluczowe wnioski
- Dwa parametry:
allowed_x_handles(biała lista) iexcluded_x_handles(czarna lista) - Wzajemnie wykluczające się: w jednym żądaniu można użyć tylko jednego
- Maksymalnie 10 nazw użytkownika na parametr
- Nazwy użytkownika wpisuje się bez symbolu
@:"elonmusk", a nie"@elonmusk" - Idealne rozwiązanie do monitoringu, śledzenia marki i analizy influencerów