# Bluesky User Posts MCP Server — Claude & Cursor | Scrapier (https://scrapier.io/scrapers/bluesky/posts/mcp/)

> Scrapier's Bluesky User Posts Scraper MCP server gives Claude, Cursor and any MCP client an account's Bluesky posts as JSON. One command. 1 credit per page.

Last updated: 2026-11-12

**GET**/api/v2/bluesky-user-posts/

## Bluesky User Posts Scraper _MCP Server_

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

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

Free API key · 1 credit per post page · 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 Bluesky pages of posts, 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 Bluesky post page for espn.com"_

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 Bluesky tools"**. The agent should find `run_scrape` and `search_endpoints`.

Tools

## Bluesky MCP Tools

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

| Tool | Returns | Inputs | Key fields | Credits |
| --- | --- | --- | --- | --- |
| `run_scrape` | Run the post page scraper | `endpoint="bluesky-user-posts", handles="..."` | input\_handle, handle, did, status, position | 1 |

### Output fields

run\_scrape · 200 OK

{
  "success": true,
  "data": {
    "handles": "espn.com",
    "handle": "espn.com",
    "did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
    "filter": "posts\_no\_replies",
    "include\_pins": true,
    "status": "ok",
    "note": null,
    "account\_followers\_count": 296583,
    "account\_posts\_count": 872,
    "page": 1,
    "page\_size": 30,
    "cursor\_sent": null,
    "bluesky\_cursor": "2025-09-25T17:06:11.912Z",
    "has\_more": true,
    "posts": \[
      {
        "input\_handle": "espn.com",
        "handle": "espn.com",
        "did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
        "status": "ok",
        "position": 1,
        "post\_id": "3muznlkmspz2x",
        "uri": "at://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsky.feed.post/3muznlkmspz2x",
        "cid": "bafyreiceaay7jrgqznvxhttsmizofewx3mj6bwebjtz76nd2wh4hix4fty",
        "url": "https://bsky.app/profile/espn.com/post/3muznlkmspz2x",
        "text": "One more sleep until NFL football is BACK. 🏈",
        "published\_at": "2026-09-08T18:27:24.700Z",
        "indexed\_at": "2026-09-08T18:27:30.159Z",
        "author\_handle": "espn.com",
        "author\_did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
        "author\_display\_name": "ESPN",
        "like\_count": 85,
        "reply\_count": 8,
        "repost\_count": 11,
        "quote\_count": 6,
        "bookmark\_count": 0,
        "is\_pinned": false,
        "is\_pinned\_copy": false,
        "is\_repost": false,
        "is\_reply": false,
        "media\_urls": \[
          "https://video.bsky.app/watch/.../playlist.m3u8"
        \],
        "thumbnail\_url": "https://video.bsky.app/watch/.../thumbnail.jpg",
        "duration\_seconds": 34.567,
        "post": {
          "id": "3muznlkmspz2x",
          "url": "https://bsky.app/profile/espn.com/post/3muznlkmspz2x",
          "content": {
            "text": "One more sleep until NFL football is BACK. 🏈",
            "...": "..."
          },
          "author": {
            "username": "espn.com",
            "display\_name": "ESPN",
            "verified": true,
            "did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
            "...": "..."
          },
          "engagement": {
            "views": null,
            "likes": 85,
            "comments": 8,
            "shares": 11,
            "saves": 0,
            "quote\_count": 6
          },
          "flags": {
            "nsfw": false,
            "spoiler": null,
            "pinned": false,
            "deleted": false
          },
          "published\_at": "2026-09-08T18:27:24.700Z",
          "record": {
            "$type": "app.bsky.feed.post",
            "...": "..."
          },
          "embed": {
            "$type": "app.bsky.embed.video#view",
            "...": "..."
          },
          "...": "(same shape as the v1 row)"
        },
        "computed": {
          "engagement\_rate": 0.0371,
          "language": "en",
          "content\_category": "sports",
          "estimated\_reach": null
        },
        "category\_keywords": \[
          "football",
          "nfl"
        \],
        "account\_followers\_count": 296583,
        "account\_posts\_count": 872,
        "filter": "posts\_no\_replies",
        "pagination": {
          "page": 1,
          "cursor\_sent": null,
          "next\_cursor": "2025-09-25T17:06:11.912Z",
          "has\_more": true
        },
        "scraped\_at": "2026-09-22T08:47:10.412Z"
      },
      {
        "position": 2,
        "post\_id": "3mpglmolczz2w",
        "text": "Former Tennessee Titans and Arizona Cardinals running back Chris Johnson...",
        "like\_count": 129,
        "reply\_count": 16,
        "repost\_count": 33,
        "quote\_count": 17,
        "...": "(same shape as row 1)"
      },
      "... 28 more rows (positions 3-30: 3mov4cob7hn2x, 3mnzrylb65e2d, ... 3lzogruhwz52e) ..."
    \],
    "warnings": \[\],
    "next\_cursor": "eyJjIjoiMjAyNS0wOS0yNVQxNzowNjoxMS45MTJaIiwiaCI6ImVzcG4uY29tIiwibGsiOnsiZmlsdGVyIjoicG9zdHNfbm9fcmVwbGllcyJ9LCJwIjoxLCJwZiI6eyJkaWQiOiJkaWQ6cGxjOng3ZDZqNTRwbTIydWZlaGtlczZqbzRqZiIsImZvbGxvd2Vyc0NvdW50IjoyOTY1ODMsImhhbmRsZSI6ImVzcG4uY29tIiwicG9zdHNDb3VudCI6ODcyfSwicGluIjpudWxsLCJwb3MiOjMwLCJzIjpbImtlczZqbzRqZi8zbXV6bmxrbXNwejJ4Iiwia2VzNmpvNGpmLzNtcGdsbW9sY3p6MnciLCIuLi4iXX0"
  }
}

Examples

## Example Prompts and Tool Calls

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

### Get post page data

Get the post page data for espn.com.

### ⚙ run\_scrape(endpoint="bluesky-user-posts", handles="espn.com")

run\_scrape(endpoint="bluesky-user-posts", handles="espn.com")

{
  "input\_handle": "espn.com",
  "handle": "espn.com",
  "did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
  "status": "ok"
}

Here are the post page details from the Scrapier API.

Workflows

## Agent Workflows

### Bluesky data pipeline

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

Feed a list, pull each post page, filter by criteria, export the result.

Compare

## Bluesky Scraper MCP vs the Official Bluesky MCP

|  | Scrapier Bluesky MCPThis page | Official Bluesky API | Apify actor over MCP |
| --- | --- | --- | --- |
| Data returned | Any public post page, typed JSON | Your own accounts and insights | Varies by actor |
| Auth needed | One Scrapier key | Bluesky 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 posts 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 Bluesky login**

- Your key stays in your client config, never in prompts
- No Bluesky 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 Bluesky scraper MCP server?

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

### How do I scrape Bluesky pages of posts 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 post page. It calls \<code>run\_scrape\</code> and reads the JSON directly.

### Does it need a Bluesky login?

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

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

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

### Can ChatGPT use the Bluesky 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/bluesky/profile/mcp/)[### Single Posts MCP

post →](https://scrapier.io/scrapers/bluesky/post/mcp/)[### All Bluesky scrapers

3 endpoints →](https://scrapier.io/scrapers/bluesky/)

## Give your agent Bluesky 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/bluesky/posts/mcp/
Site index for AI agents: https://scrapier.io/llms.txt
