Φιλτράρισμα με βάση λογαριασμούς X
Σε αυτήν τη σελίδα
Στόχευση συγκεκριμένων λογαριασμών στο X
Όπως η Αναζήτηση Ιστού σάς επιτρέπει να φιλτράρετε ανά domain, η Αναζήτηση X σάς επιτρέπει να φιλτράρετε ανά λογαριασμούς (handles). Μπορείτε να περιορίσετε τις αναζητήσεις σε αναρτήσεις από ένα συγκεκριμένο σύνολο λογαριασμών ή να αποκλείσετε ορισμένους λογαριασμούς από τα αποτελέσματα. Αυτό το φιλτράρισμα είναι απαραίτητο για περιπτώσεις χρήσης όπως η παρακολούθηση, η παρακολούθηση επωνυμίας ή η ανάλυση επιρροής.
Οι δύο παράμετροι φιλτραρίσματος
Η Αναζήτηση X προσφέρει δύο παραμέτρους φιλτραρίσματος λογαριασμών:
allowed_x_handles: περιορίζει την αναζήτηση σε αναρτήσεις από τους αναφερόμενους λογαριασμούς (allowlist)excluded_x_handles: αποκλείει αναρτήσεις από τους αναφερόμενους λογαριασμούς (blocklist)
Όπως και στην Αναζήτηση Ιστού, αυτές οι παράμετροι είναι αμοιβαία αποκλειόμενες. Δεν μπορείτε να χρησιμοποιήσετε και τις δύο στο ίδιο αίτημα.
Κάθε παράμετρος δέχεται έναν πίνακα με έως 10 handles (σε σύγκριση με 5 domains για την Αναζήτηση Ιστού).
Χρήση του allowed_x_handles (allowlist)
Αυτή η παράμετρος είναι ιδανική για την παρακολούθηση επικοινωνιών από συγκεκριμένους λογαριασμούς:
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"]
}]
)
Το μοντέλο θα αναζητήσει μόνο αναρτήσεις που δημοσιεύθηκαν από αυτούς τους λογαριασμούς.
Περιπτώσεις χρήσης Allowlist
- Ανταγωνιστική νοημοσύνη: παρακολουθήστε τις ανακοινώσεις των ανταγωνιστών σας
- Παρακολούθηση επωνυμίας: εντοπίστε τους επίσημους λογαριασμούς σας και εκείνους των πρεσβευτών σας
- Ανάλυση επιρροής: συγκεντρώστε απόψεις από έναν πίνακα ειδικών
- Θεσμική παρακολούθηση: ακολουθήστε λογαριασμούς από ρυθμιστικές αρχές ή επίσημους οργανισμούς
Χρήση του excluded_x_handles (blocklist)
Αυτή η παράμετρος σάς επιτρέπει να αποκλείετε ορισμένους λογαριασμούς, όπως bots ή άσχετους λογαριασμούς:
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"]
}]
)
Περιπτώσεις χρήσης Blocklist
- Αποκλεισμός bots: αφαιρέστε τους αυτοματοποιημένους λογαριασμούς από τα αποτελέσματα
- Αποκλεισμός spam: φιλτράρετε λογαριασμούς γνωστούς για περιεχόμενο χαμηλής ποιότητας
- Αποκλεισμός των δικών σας λογαριασμών: αναλύστε εξωτερικές αντιδράσεις χωρίς τις δικές σας αναρτήσεις
Σύνταξη 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"]
})]
Σημειώστε τη σύμβαση camelCase στο JavaScript SDK: allowedXHandles αντί για allowed_x_handles.
Βέλτιστες πρακτικές
Επιλογή μεταξύ allowlist και blocklist
Χρησιμοποιήστε το allowlist όταν έχετε ένα καθορισμένο σύνολο λογαριασμών και θέλετε μόνο τις αναρτήσεις τους. Αυτή είναι η πιο ακριβής και αποδοτική μέθοδος ως προς τα tokens.
Χρησιμοποιήστε το blocklist όταν θέλετε μια ευρεία αναζήτηση αλλά χρειάζεται να την καθαρίσετε εξαλείφοντας γνωστές πηγές θορύβου.
Βελτιστοποίηση του αριθμού των handles
Με όριο τα 10 handles, να είστε επιλεκτικοί. Εάν χρειάζεται να παρακολουθήσετε περισσότερους από 10 λογαριασμούς, ομαδοποιήστε τα αιτήματά σας ανά θέμα ή πραγματοποιήστε πολλαπλές διαδοχικές κλήσεις.
Μορφή handle
Τα handles δεν περιλαμβάνουν το σύμβολο @ (για παράδειγμα, xaboratory). Επαληθεύστε ότι τα handles είναι σωστά· ένα handle με ορθογραφικό λάθος απλώς δεν θα επιστρέψει αποτελέσματα για αυτόν τον λογαριασμό.
Βασικά σημεία
- Δύο παράμετροι:
allowed_x_handles(allowlist) καιexcluded_x_handles(blocklist) - Αμοιβαία αποκλειόμενες: μόνο μία τη φορά ανά αίτημα
- Μέγιστο 10 handles ανά παράμετρο
- Τα handles γράφονται χωρίς το
@:"elonmusk", όχι"@elonmusk" - Ιδανικό για παρακολούθηση, παρακολούθηση επωνυμίας και ανάλυση επιρροής