XCrap 使用方法

挑一个跟你干活方式对得上的。它们拿到的是同一份数据。

在本站用

把链接粘进首页的输入框。你会拿到预览、Markdown、原始 JSON，以及所有附带媒体的下载链接。什么都不用装。

xcrap.cc

任何帖子在这里也有一个固定链接：把地址栏里的 x.com 换成 xcrap.cc，页面就会带完整预览卡渲染出来。

x.com

x.com/jack/status/20

xcrap.cc

xcrap.cc/jack/status/20

在命令行用

每个接口都是普通的 GET。curl、wget、HTTPie、浏览器地址栏，手边有什么用什么。

# 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'

在智能体里，走 MCP

MCP 服务器把每个接口都暴露成一个工具，模型不用你写胶水代码就能读 X。把这段加进客户端配置，然后重启。

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

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

在智能体里，不走 MCP

如果你的框架不支持 MCP，那就下载技能文件。它是一份 Markdown 文档，把整套 API 教给模型。丢进 prompt、system message，或者你的 skills 目录里。

skills.md llms.txt openapi.json

在代码里

Node 和 Python 的官方 SDK。两个都是同一套 REST API 的薄封装，带类型，没有运行时依赖。

// 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,
)