How to use XCrap

On this site

Paste a link into the box on the homepage. You get a preview, the Markdown, the raw JSON, and download links for any attached media. Nothing to install.

From the command line

Every endpoint is a plain GET. curl, wget, HTTPie, a browser address bar, whatever you have.

# One post, as markdown
curl 'https://xcrap.cc/v1/tweet?url=https://x.com/jack/status/20&format=markdown'

# A whole thread, from the first post
curl 'https://xcrap.cc/v1/thread?url=https://x.com/naval/status/1002103360646823936&max_tweets=40&format=markdown'

# Ask by header instead of query string
curl -H 'Accept: text/markdown' 'https://xcrap.cc/v1/tweet?url=20'

# Fifty posts in one request
curl -X POST https://xcrap.cc/v1/bulk \
  -H 'content-type: application/json' \
  -d '{"urls":["https://x.com/jack/status/20","1671370010743263233"]}'

# Save the video from a post
curl -OJ 'https://xcrap.cc/v1/media/download?url=1671370010743263233&index=0'

In your agent, over MCP

The MCP server exposes each endpoint as a tool, so a model can read X without you writing glue code. Add this to your client config and restart it.

{
  "mcpServers": {
    "xcrap": {
      "command": "npx",
      "args": ["-y", "@xcrapcc/mcp"]
    }
  }
}

For Claude Code, run this in your project instead:

claude mcp add xcrap -- npx -y @xcrapcc/mcp

In your agent, without MCP

If your harness does not speak MCP, download the skill file. It is one Markdown document that teaches a model the whole API. Drop it into your prompt, your system message, or your skills folder.

skills.md llms.txt openapi.json

In code

Official SDKs for Node and Python. Both are thin wrappers over the same REST API, with types and no runtime dependencies.

// Node
npm install @xcrapcc/sdk

import { Xcrap } from '@xcrapcc/sdk';

const xcrap = new Xcrap();
const thread = await xcrap.thread(
  'https://x.com/naval/status/1002103360646823936',
  { markdown: true }
);

# Python
pip install xcrap-sdk

from xcrap import Xcrap

xcrap = Xcrap()
thread = xcrap.thread(
    "https://x.com/naval/status/1002103360646823936",
    markdown=True,
)

In a chat

Paste an xcrap.cc link into Discord, Slack, Telegram or WhatsApp and it unfurls into a card with the author, the text and the post’s image. Swap x.com for xcrap.cc, send it, done. Nobody on the other end needs an account to read it.