Web Search Advanced - Tweet Category
Tool Restriction (Critical)
ONLY use web_search_advanced_exa with category: "tweet" . Do NOT use other categories or tools.
Filter Restrictions (Critical)
The tweet category has LIMITED filter support. The following parameters are NOT supported and will cause 400 errors:
-
includeText
-
NOT SUPPORTED
-
excludeText
-
NOT SUPPORTED
-
includeDomains
-
NOT SUPPORTED
-
excludeDomains
-
NOT SUPPORTED
-
moderation
-
NOT SUPPORTED (causes 500 server error)
Supported Parameters
Core
-
query (required)
-
numResults
-
type ("auto", "fast", "deep", "neural")
Date filtering (ISO 8601) - Use these instead of text filters!
-
startPublishedDate / endPublishedDate
-
startCrawlDate / endCrawlDate
Content extraction
-
textMaxCharacters / contextMaxCharacters
-
enableHighlights / highlightsNumSentences / highlightsPerUrl / highlightsQuery
-
enableSummary / summaryQuery
Additional
-
additionalQueries
-
useful for hashtag variations
-
livecrawl / livecrawlTimeout
-
use "preferred" for recent tweets
Token Isolation (Critical)
Never run Exa searches in main context. Always spawn Task agents:
-
Agent calls web_search_advanced_exa with category: "tweet"
-
Agent merges + deduplicates results before presenting
-
Agent returns distilled output (brief markdown or compact JSON)
-
Main context stays clean regardless of search volume
When to Use
Use this category when you need:
-
Social discussions on a topic
-
Product announcements from company accounts
-
Developer opinions and experiences
-
Trending topics and community sentiment
-
Expert takes and threads
Examples
Recent tweets on a topic:
web_search_advanced_exa { "query": "Claude Code MCP experience", "category": "tweet", "startPublishedDate": "2025-01-01", "numResults": 20, "type": "auto", "livecrawl": "preferred" }
Search with specific keywords (put keywords in query, not includeText):
web_search_advanced_exa { "query": "launching announcing new open source release", "category": "tweet", "startPublishedDate": "2025-12-01", "numResults": 15, "type": "auto" }
Developer sentiment (use specific query terms instead of excludeText):
web_search_advanced_exa { "query": "developer experience DX frustrating painful", "category": "tweet", "numResults": 20, "type": "deep", "livecrawl": "preferred" }
Output Format
Return:
-
Results (tweet content, author handle, date, engagement if visible)
-
Sources (Tweet URLs)
-
Notes (sentiment summary, notable accounts, threads vs single tweets)
Important: Be aware that tweet content can be informal, sarcastic, or context-dependent.