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

Filtrowanie po kontach i datach na X

Lekcja 6 z 14 Zaktualizowano 30 lipca 2026 Początkujący
Na tej stronie
  1. Precyzyjne targetowanie wyszukiwań w X
  2. Filtrowanie po kontach: allowed_x_handles i excluded_x_handles
  3. Filtrowanie po datach: from_date i to_date
  4. Łączenie filtrów
  5. Budowa dynamicznego systemu monitoringu
  6. Ćwiczenie
  7. Kluczowe wnioski

Precyzyjne targetowanie wyszukiwań w X

Wyszukiwarka X zyskuje prawdziwą wartość, gdy opanujesz jej parametry filtrowania. Zamiast pobierać surowy strumień postów, możesz targetować konkretne konta, ustawiać precyzyjne przedziały czasowe i wykluczać źródła szumu. Te filtry przekształcają uniwersalne narzędzie wyszukiwania w precyzyjny instrument monitoringu.

Filtrowanie po kontach: allowed_x_handles i excluded_x_handles

Monitorowanie konkretnych kont

Parametr allowed_x_handles ogranicza wyszukiwanie do postów opublikowanych przez wymienione przez Ciebie konta. Możesz jednocześnie targetować do 10 kont:

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"
        ]
    }]
)

Wykluczanie kont generujących szum

Parametr excluded_x_handles działa odwrotnie. Pozwala uwzględnić wszystkie konta z wyjątkiem tych, które określisz. Przydaje się do eliminowania botów lub kont z nieistotną treścią:

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"]
    }]
)

Zasada wzajemnej wyłączności

Podobnie jak w przypadku domen internetowych, allowed_x_handles i excluded_x_handles są wzajemnie wyłączne. Nie możesz łączyć ich w jednym wywołaniu. Limit wynosi 10 kont na parametr, czyli dwukrotnie więcej niż dla domen internetowych.

Filtrowanie po datach: from_date i to_date

Parametry czasowe pozwalają zdefiniować precyzyjne okno wyszukiwania w formacie ISO 8601 (YYYY-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"
    }]
)

Te filtry są szczególnie przydatne do:

  • Analizy wpływu wydarzenia: zdefiniuj okres wokół zdarzenia
  • Porównania nastrojów przed i po: uruchom dwa zapytania z różnymi przedziałami czasowymi
  • Unikania starego szumu: skup się na najnowszych dyskusjach

Użycie z natywnym SDK dla Pythona

SDK xAI dla Pythona akceptuje obiekty datetime oprócz ciągów znaków w formacie ISO:

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)
    )]
)

Konwencja camelCase w JavaScript

SDK Vercel AI stosuje konwencję camelCase dla nazw parametrów:

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk"],
  fromDate: "2026-03-01",
  toDate: "2026-03-31"
})]

Łączenie filtrów

Możesz łączyć filtry kont i dat w jednym wywołaniu, aby uzyskać maksymalną precyzję:

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"
    }]
)

Budowa dynamicznego systemu monitoringu

Łącząc te filtry programistycznie, możesz zbudować konfigurowalne narzędzie do monitoringu:

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")
    }

# Monitoruj liderów AI przez ostatni tydzień
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Ćwiczenie

Skonfiguruj targetowane wyszukiwanie w X dla 3 do 5 wpływowych kont w Twojej branży. Ustaw jednotygodniowe okno czasowe i porównaj wyniki z wyszukiwaniem bez filtrów kont. Zmierz różnicę w trafności wyników.

Kluczowe wnioski

  • allowed_x_handles i excluded_x_handles filtrują po kontach (maksymalnie 10 dla każdego)
  • Oba parametry kont są wzajemnie wyłączne
  • from_date i to_date definiują okno czasowe w formacie YYYY-MM-DD
  • Daty można łączyć z filtrami kont
  • SDK dla Pythona akceptuje obiekty datetime, a SDK dla JavaScript używa konwencji camelCase
  • Te filtry przekształcają wyszukiwarkę X z uniwersalnego narzędzia w instrument targetowanego monitoringu