# Threads Search MCP Server — Claude & Cursor | Scrapier (https://scrapier.io/scrapers/threads/search/mcp/)

> Scrapier's Threads Search Scraper MCP server gives Claude, Cursor and any MCP client Threads data as JSON. One command connects it. 1 credit per call.

Last updated: 2026-11-11

**GET**/api/v2/threads-search/

## Threads Search Scraper _MCP Server_

Give Claude, Cursor and ChatGPT a tool for any public Threads page of search results. One command connects it; every call returns typed JSON. 1 credit per page of search results.

[Get a free API key →](https://app.scrapier.io/sign-up) [Jump to setup](#setup)

Free API key · 1 credit per page of search results · failed calls free

Last updated 9 Nov 2026

Live agent run

Copy for your AI agent

Install

## Connect in one command

Quick answerScrapier's MCP server gives **Claude, Cursor and any MCP client** tools for public Threads pages of search results, returned as JSON. One command connects it. Each call costs 1 credit.

terminal

claude mcp add -t http scrapier \\
  https://mcp.scrapier.io/mcp \\
  --header "X-API-Key: YOUR\_API\_KEY"

Then ask: _"Get the Threads page of search results for AI"_

Connect

## Custom connector

Connect any client that supports remote MCP with one URL and your API key.

### Custom connector

Any MCP client

Paste one URL into any client that supports remote MCP and send your Scrapier API key in an `X-API-Key` header.

`https://mcp.scrapier.io/mcp`

Where to paste it

- **Claude**Settings → Connectors → Add
- **ChatGPT**Settings → Apps → Developer mode → Create
- **Cursor**Settings → MCP → Add new server

[Step-by-step setup ↓](#setup)

Setup

## Setup in Claude, Cursor, Windsurf and ChatGPT

Pick your client. Three steps, under a minute.

1. Get a free API key from your Scrapier dashboard.
2. Run the command below in your terminal.
3. Restart Claude Code and run `/mcp` to see the tools.

terminal

claude mcp add -t http scrapier https://mcp.scrapier.io/mcp --header "X-API-Key: YOUR\_API\_KEY"

claude · ~/project

**›** /mcp

Manage MCP servers

● scrapier · connected · 6 tools

└ search\_endpoints

└ run\_scrape

└ …4 more

**›**

### Verify the connection

Ask **"List your Threads tools"**. The agent should find `run_scrape` and `search_endpoints`.

Tools

## Threads MCP Tools

Use `search_endpoints` to discover, `run_scrape` to call.

| Tool | Returns | Inputs | Key fields | Credits |
| --- | --- | --- | --- | --- |
| `run_scrape` | Run the page of search results scraper | `endpoint="threads-search", queries="..."` | postId, postUrl, username, isVerified, captionText | 1 |

### Output fields

run\_scrape · 200 OK

{
  "success": true,
  "data": {
    "query": "AI",
    "page": 1,
    "page\_size": 18,
    "posts": \[
      {
        "postId": "3921506418558274796",
        "postUrl": "https://www.threads.com/@theeconomist/post/DLabcXYZ",
        "username": "theeconomist",
        "isVerified": true,
        "captionText": "Today the cost of providing AI services is subsidised by the labs...",
        "likeCount": 1240,
        "directReplyCount": 87,
        "repostCount": 34,
        "takenAt": 1718628028,
        "takenAtISO": "2026-06-17T12:40:28.000Z",
        "nextCursor": "GDA6...opaque-end-cursor",
        "keyword": "AI",
        "scraped\_at": "2026-06-18T12:00:00.000Z"
      }
    \],
    "next\_cursor": "eyJxIjoiQUkiLCJyIjowLCJhIjoiR0RBNi4uLiIsImxrIjp7fSwicCI6MX0"
  }
}

Examples

## Example Prompts and Tool Calls

The prompt, the tool call, the JSON and the answer.

### Get page of search results data

Get the page of search results data for AI.

### ⚙ run\_scrape(endpoint="threads-search", queries="AI")

run\_scrape(endpoint="threads-search", queries="AI")

{
  "postId": "3921506418558274796",
  "postUrl": "https://www.threads.com/@theeconomist/post/DLabcXYZ",
  "username": "theeconomist",
  "isVerified": true
}

Here are the page of search results details from the Scrapier API.

Workflows

## Agent Workflows

### Threads data pipeline

1. input list
2. run\_scrape
3. filter results
4. export

Feed a list, pull each page of search results, filter by criteria, export the result.

Compare

## Threads Scraper MCP vs the Official Threads MCP

|  | Scrapier Threads MCPThis page | Official Threads API | Apify actor over MCP |
| --- | --- | --- | --- |
| Data returned | Any public page of search results, typed JSON | Your own accounts and insights | Varies by actor |
| Auth needed | One Scrapier key | Threads app + business account | Apify token |
| Cost model | 1 credit per call | Free once approved | Compute units per run |
| Rate limits | 3 parallel per key | Per-user hourly quota | Per actor |
| Best for | Research, enrichment, monitoring | Own-account analytics | Custom one-off crawls |

### Limits

- Public data only — private pages of search results return identity fields only
- Counts are live at call time; no history unless you store it

Billing

## Credits, Rate Limits and Security

Credits per call**1**

Parallel requests**3 per key**

Auth**One Scrapier key, no Threads login**

- Your key stays in your client config, never in prompts
- No Threads account or cookies are used
- Failed calls cost 0 credits
- Rotate or revoke keys any time from the dashboard

[See full pricing →](https://scrapier.io/pricing/)

Troubleshooting

## Troubleshooting

### Tools not showing

Restart the client after editing its config. In Claude Code run /mcp; in Cursor check the server toggle is on.

### 401 invalid key

The key is missing or mistyped. Copy it again from the dashboard.

### 429 rate limit

You exceeded your plan's parallel requests. The agent should wait for Retry-After.

### Timeout on large requests

Batch in smaller groups, or raise the client timeout to 210 seconds.

FAQ

## Frequently Asked Questions

### Is there a Threads scraper MCP server?

Yes. Scrapier's MCP server exposes Threads page of search results tools to Claude, Cursor, Windsurf and ChatGPT. One command connects it and every call returns typed JSON.

### How do I scrape Threads pages of search results with Claude?

Run \<code>claude mcp add -t http scrapier https://mcp.scrapier.io/mcp\</code> with your API key, then ask Claude for any public page of search results. It calls \<code>run\_scrape\</code> and reads the JSON directly.

### Does it need a Threads login?

No. The server reads public data only and uses no Threads account or cookies.

### How much does a Threads MCP call cost?

1 credit per call — about $1.58 per 1,000 pages of search results on the Pro plan. Failed calls are free.

### Can ChatGPT use the Threads scraper?

Yes. Add Scrapier as a custom connector in ChatGPT's developer mode and the same tools appear in chat.

More servers

## Related MCP Servers

[### Profile Info MCP

profile →](https://scrapier.io/scrapers/threads/profile/mcp/)[### User Posts MCP

posts →](https://scrapier.io/scrapers/threads/posts/mcp/)[### All Threads scrapers

6 endpoints →](https://scrapier.io/scrapers/threads/)

## Give your agent Threads data

1 tool · JSON · one key

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

---
Canonical page: https://scrapier.io/scrapers/threads/search/mcp/
Site index for AI agents: https://scrapier.io/llms.txt
