Filtrowanie po kontach i datach na X
Na tej stronie
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_handlesiexcluded_x_handlesfiltrują po kontach (maksymalnie 10 dla każdego)- Oba parametry kont są wzajemnie wyłączne
from_dateito_datedefiniują okno czasowe w formacieYYYY-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