Threads Scraper MCP Server

Give AI assistants structured, read-only access to public Threads.net data (profiles + posts).

Uses Playwright headless Chrome to bypass Threads’ login wall - no authentication needed.

Example Use Cases

Analyze posting strategies and engagement metrics for any public Threads profile:

---

Claude Desktop Setup

1. Install Dependencies

# Clone the repository
git clone https://github.com/dkyazzentwatwa/threads-mcp-crawler.git
cd threads-mcp-crawler

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install package
pip install -e .

# Install Playwright browser (required)
playwright install chromium

2. Add to Claude Desktop Config

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "threads-scraper": {
      "command": "/path/to/threads-mcp-crawler/.venv/bin/python3",
      "args": [
        "/path/to/threads-mcp-crawler/run_mcp_server.py"
      ]
    }
  }
}

Note: Replace /path/to/threads-mcp-crawler with your actual installation path.

3. Restart Claude Desktop

The tools will be available immediately. Test with:

"Get profile info for @zuck"

---

Available Tools

get_profile

Get profile information including bio, follower counts, verification status.

"Get profile info for @meta"

Returns: handle, display_name, bio, follower_count, following_count, thread_count, is_verified, is_private, url

get_profile_threads

Fetch recent threads from a profile.

"Show me the last 20 posts from @zuck"

Parameters:

• handle: Username
• limit: 0 for all (default 10, capped by THREADS_MAX_PAGINATION_REQUESTS)

Returns: List of threads with text, engagement (likes/replies), timestamps, media URLs

get_thread

Get single thread by URL or ID.

"Get details for https://threads.net/@zuck/post/ABC123"

get_thread_replies

Get direct replies to a thread.

"Show me replies to this thread"

search_threads

Search for threads by query or hashtag.

"Search for threads about AI"
"Find posts with #technology"

Parameters:

• query: Search text or hashtag