Comment utiliser XCrap

Sur ce site

Collez un lien dans le champ de la page d'accueil. Vous obtenez un aperçu, le Markdown, le JSON brut et des liens de téléchargement pour les médias joints. Rien à installer.

En ligne de commande

Chaque endpoint est un simple GET. curl, wget, HTTPie, une barre d'adresse, ce que vous avez sous la main.

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

Dans votre agent, via MCP

Le serveur MCP expose chaque endpoint comme un outil : un modèle peut lire X sans que vous écriviez de glue code. La version hébergée ne demande rien à installer : ajoutez ceci à la config de votre client et redémarrez-le.

{
  "mcpServers": {
    "xcrap": { "url": "https://xcrap.cc/mcp" }
  }
}

Pour Claude Code, lancez plutôt ceci dans votre projet :

claude mcp add --transport http xcrap https://xcrap.cc/mcp

Vous préférez le lancer sur votre machine ? Le paquet npm sert les mêmes outils en stdio :

npx -y @xcrapcc/mcp

Dans votre agent, sans MCP

Si votre harness ne parle pas MCP, téléchargez le fichier skill. C'est un seul document Markdown qui enseigne toute l'API à un modèle. Mettez-le dans votre prompt, votre message système ou votre dossier de skills.

skills.md llms.txt openapi.json

En code

SDK officiels pour Node et Python. Deux fines couches sur la même API REST, typées et sans dépendances à l'exécution.

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

Dans une discussion

Collez un lien xcrap.cc dans Discord, Slack, Telegram ou WhatsApp et il se déplie en une carte avec l’auteur, le texte et l’image du post. Remplacez x.com par xcrap.cc, envoyez, c’est tout. Personne en face n’a besoin d’un compte pour le lire.