Przejdź do głównej treści
Polski— Wybierz język
Menu

Filtrowanie po kontach na X

Lekcja 9 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Targetowanie konkretnych kont na X
  2. Dwa parametry filtrowania
  3. Używanie allowed_x_handles (biała lista)
  4. Używanie excluded_x_handles (czarna lista)
  5. Składnia SDK
  6. Najlepsze praktyki
  7. Kluczowe wnioski

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) i excluded_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