x-interact

Interact with X.com (Twitter) via Tavily web search and extraction. Search tweets, extract content from linked URLs, monitor accounts and topics. Requires Tavily API key (free tier works).

3,891 stars

byopenclaw

Complexity: easy

View on GitHub Installation ↓

About this skill

The x-interact skill provides AI agents with a powerful method to access and process information from X.com (Twitter) by integrating with the Tavily web search and extraction service. It bypasses direct X.com blocking issues by using Tavily's search index to find tweets, profiles, and threads, allowing for comprehensive data gathering. This skill enables an AI agent to perform various operations, including searching for tweets by user or keyword, extracting content from external URLs linked within tweets (e.g., news articles, blog posts), and conducting deep research on specific topics by combining search and extraction functionalities. It's particularly useful for agents needing to gather real-time social media intelligence without running into common access restrictions. Users would deploy this skill to empower their AI agents with social media monitoring, content analysis, and information retrieval specifically from the X.com platform. It's an essential tool for agents involved in market research, sentiment analysis, competitive intelligence, or any task requiring up-to-date information from X.com.

Best use case

The primary use case is for AI agents to conduct research, monitoring, and content extraction from X.com (Twitter). It benefits researchers, analysts, content creators, and developers who need to programmatically access and process social media data for insights, trend tracking, or content generation, overcoming the limitations of direct API access or web scraping.

Interact with X.com (Twitter) via Tavily web search and extraction. Search tweets, extract content from linked URLs, monitor accounts and topics. Requires Tavily API key (free tier works).

Users should expect detailed search results of X.com content or extracted text from linked URLs, providing relevant information for their research or monitoring tasks.

Practical example

Example input

An AI agent receives the task: 'Find the latest 5 tweets from Vitalik Buterin mentioning Ethereum, then extract content from any linked news articles in those tweets.'

Example output

The agent would return a list of 5 relevant tweets from Vitalik Buterin, each with its content and metadata, along with full extracted text from any external URLs mentioned within those tweets.

When to use this skill

When you need to search for specific tweets, users, or topics on X.com.
When you need to extract full content from external articles or pages linked within X.com tweets.
When conducting comprehensive research on a subject that requires social media input.
When direct access to X.com is blocked or rate-limited for scraping purposes.

When not to use this skill

When direct, real-time interaction (e.g., posting, liking, replying) with X.com accounts is required.
When you need to monitor X.com at a very high frequency that exceeds Tavily's free tier rate limits (20 requests/minute).
When you specifically need official X.com API data not indexed by Tavily.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/x-interact/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/0x-wzw/x-interact/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/x-interact/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How x-interact Compares

Feature / Agent	x-interact	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	easy	N/A

Frequently Asked Questions

What does this skill do?

Interact with X.com (Twitter) via Tavily web search and extraction. Search tweets, extract content from linked URLs, monitor accounts and topics. Requires Tavily API key (free tier works).

How difficult is it to install?

The installation complexity is rated as easy. You can find the installation instructions above.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

AI Agent for Product Research

Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.

Best AI Skills for ChatGPT

Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.

AI Agent for SaaS Idea Validation

Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.

SKILL.md Source

# X.com Interact via Tavily

Tavily is configured as an MCP server and provides the interface for X.com content through search indexing.

## Prerequisites

- **Tavily API key** — free at [tavily.io](https://tavily.io)
- **mcporter** — OpenClaw skill for MCP tool calling

## Setup Tavily MCP

```bash
mcporter config add tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<YOUR_KEY>
```

## Core Operations

### Search X.com

```bash
# Search for a user's tweets
mcporter call tavily.tavily_search query="from:username keyword" max_results=5

# Search tweets by keyword
mcporter call tavily.tavily_search query="keyword site:x.com" max_results=10

# Search for a specific tweet or thread
mcporter call tavily.tavily_search query="site:x.com username tweet context" max_results=3
```

### Extract Content from Linked URLs

```bash
# Extract from a news article or blog linked in a tweet
mcporter call tavily.tavily_extract urls='["https://example.com/article"]'
```

### Deep Research on a Topic

```bash
# Full research with Tavily (search + extract combined)
mcporter call tavily.tavily_research query="topic name" search_depth="basic" max_results=5
```

## Notes

- X.com blocks direct extraction (403). Use `tavily_search` to find tweet content via search index, or ask Z to paste tweet text.
- Tavily search indexes X.com profiles, tweet URLs, and threads.
- Combine Tavily search for finding tweets + Tavily extract for diving into linked articles.
- Rate limit: 20 requests/minute on Tavily free tier.

## Example Workflow

1. **Find tweets:** `mcporter call tavily.tavily_search query="from:vitalikbuterin ethereum" max_results=5`
2. **Get thread context:** `mcporter call tavily.tavily_search query="site:x.com vitalikbuterin tweet_thread" max_results=3`
3. **Extract linked article:** `mcporter call tavily.tavily_extract urls='["https://example.com/linked-article"]'`

## Rate Limits

- Tavily free tier: 20 requests/minute, 1000 requests/month
- No rate limits on GeckoTerminal/DeFiLlama when used alongside

Data & Research