X Article Exporter
Export X (Twitter) articles as high-quality PDFs — with optional translation and dark mode.
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
Export X (Twitter) articles as high-quality PDFs — with optional translation and dark mode.
Export X (Twitter) articles as clean, shareable PDFs — with optional translation, dark mode, an HTTP API, and MCP server for Claude Code.
go install github.com/annismckenzie/x-article-exporter@latest
Or build from source:
git clone https://github.com/annismckenzie/x-article-exporter.git
cd x-article-exporter
go build -o x-article-exporter .
Open x.com in your browser, then:
https://x.comauth_token and ct0Save to ~/.config/x-article-exporter/config.yaml:
auth_token: "your-auth-token"
ct0: "your-ct0"
x-article-exporter https://x.com/user/article/1234567890
This creates a PDF in the current directory named after the article title.
All settings go in ~/.config/x-article-exporter/config.yaml. CLI flags override config values.
# Required: X authentication cookies (get from browser dev tools)
auth_token: "your-auth-token"
ct0: "your-ct0"
# Optional: Ollama model for translation (default: translategemma:12b)
# ollama_model: "translategemma:12b"
# Optional: Render PDFs in dark mode
# dark_mode: true
# Server mode configuration (used with --serve)
server:
port: 8080
host: "127.0.0.1"
job_ttl_minutes: 60
default_rate_limit_per_hour: 20
max_concurrent_jobs: 4
api_keys:
- key: "your-api-key-here"
name: "default"
# rate_limit_per_hour: 20 # omit to use default_rate_limit_per_hour
See config.example.yaml for the full reference.
x-article-exporter [flags] <article-url>
Examples:
# Basic export
x-article-exporter https://x.com/elonmusk/article/1234567890
# Translate to German
x-article-exporter -translate de https://x.com/elonmusk/article/1234567890
# Dark mode with custom output path
x-article-exporter -dark -output ~/Documents/article.pdf https://x.com/elonmusk/article/1234567890
Start the server:
x-article-exporter --serve
Export workflow:
# Submit an article for export
curl -X POST -H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{"url":"https://x.com/user/article/123"}' \
http://localhost:8080/export
# Check job status
curl -H "Authorization: Bearer your-api-key" \
http://localhost:8080/export/{id}
# Download the PDF
curl -H "Authorization: Bearer your-api-key" \
http://localhost:8080/export/{id}/pdf -o article.pdf
See API.md for full endpoint reference with request/response schemas.
Register as a Claude Code tool:
claude mcp add x-article-exporter /path/to/x-article-exporter -- --mcp
Then ask Claude: "Export this article as a PDF: https://x.com/user/article/123"
See docs/mcp-setup.md for the full setup guide, available tools, and troubleshooting.
TweetResultByRestId), parses the Draft.js content model# Run tests
make test
# Run end-to-end test (requires auth config)
make test-article
# Visual preview (generates PDF + PNGs)
make preview
make preview-dark
Architecture and design documents are in shaping/.
Export X (Twitter) articles as clean, shareable PDFs — with optional translation, dark mode, an HTTP API, and MCP server for Claude Code.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
X Article Exporter runs locally over stdio.
Last checked 2026-10-27. Export X (Twitter) articles as clean, shareable PDFs — with optional translation, dark mode, an HTTP API, and MCP server for Claude Code.