mcpField
W
web-search-advanced-tweet

web-search-advanced-tweet

github.com/exa-labsProductivity5.2k40 installsUpdated today
Repository

About web-search-advanced-tweet

A skill for using Exa advanced search to find tweets, intended for research into social discussions, announcements, and developer opinions. It restricts the search category and parameters, and routes result processing through an Agent.

Key features

  1. 01Tweet-category search only
  2. 02Supported date filters
  3. 03Content extraction and summary options
  4. 04Agent-based result merging and deduplication
  5. 05Guidance for social and sentiment research

Use cases

  1. 01Find recent product announcements
  2. 02Summarize developer opinions on a topic
  3. 03Track trending topics and community sentiment

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/exa-labs/exa-mcp-server --skill web-search-advanced-tweet

After installing, type/web-search-advanced-tweetin Claude Code to confirm it loaded.

Details

From the project README

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:

  1. Results (tweet content, author handle, date, engagement if visible)
  2. Sources (Tweet URLs)
  3. Notes (sentiment summary, notable accounts, threads vs single tweets)

Important: Be aware that tweet content can be informal, sarcastic, or context-dependent.

Comments

Markdown supported