PS

pranrichh/spectre-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

11 stars 3 forks 质量 64 趋势 22

The fastest X/Twitter automation for AI agents.

概览

The fastest X/Twitter automation for AI agents. 104 tools · no browser · no API keys · no monthly fees Quick Start · Tools · Why Spectre? · Safety · Integrations · Reference Spectre is an MCP server that gives AI agents 104 tools for X/Twitter automation — from search and posting to DMs, lists, and communities. Under the hood, it talks directly to X's internal GraphQL and REST APIs. No browser to spin up, no Puppeteer to maintain, no DOM scraping that breaks on UI changes. 1. Open and make sure you're logged in 2. Open (F12 or Ctrl+Shift+I) 3. Go to → → select 4. Find and copy these two values: - — long hex string (e.g. a1b2c3d4...) - — 160-character hex string ct0 is exactly 160 hex characters. Double-check you copied the full value — partial cookies will fail silently. Add to your MCP client config (~/.hermes/config.yaml, claude_desktop_config.json, .cursor/mcp.json, or equivalent): For client-specific setup (Hermes skill, Claude, Cursor, Python), see Integrations.

README

以下为原文 README 节选,完整内容请查看原文。

Spectre MCP

The fastest X/Twitter automation for AI agents.

104 tools · no browser · no API keys · no monthly fees

Quick Start · Tools · Why Spectre? · Safety · Integrations · Reference


Spectre is an MCP server that gives AI agents 104 tools for X/Twitter automation — from search and posting to DMs, lists, and communities. Under the hood, it talks directly to X’s internal GraphQL and REST APIs. No browser to spin up, no Puppeteer to maintain, no DOM scraping that breaks on UI changes.

Spectre XActions twikit
Architecture Direct GraphQL/REST Puppeteer (headless browser) Python API wrapper
Speed <1s per request 3–10s (browser startup) ~1s per request
Memory ~10 MB ~200 MB+ (Chromium) ~10 MB
MCP Server ✓ 104 tools ~50 API tools ✗ None
Account Pool ✓ Multi-account auto-rotation ✗ Single auth_token ✗ Single session
Browser Required ✗ Never ✓ Always ✗ Never
DOM Breakage Risk ✗ None ~ breaks on UI changes ✗ None
Media Upload ✓ Cookie-based (no API keys) ~ requires API keys ✗
Lists ✓ Full CRUD + members + subscribe ✗ ✗
Drafts & Scheduled ✓ Full CRUD ~ Basic ✗
Bookmark Folders ✓ Full CRUD + timeline ✗ ✗
DM Search ✓ All / groups / people ✗ ✗
Community Notes ✓ Read + rate ✗ ✗
Highlights ✓ Create, delete, get ✗ ✗
Notifications ✓ Full timeline ✗ ✗
Language Python JavaScript Python

1. Install

pipx install spectre-mcp    # or: uv tool install spectre-mcp

2. Add Your X Account

Extract cookies from your browser:

  1. Open x.com and make sure you’re logged in
  2. Open DevTools (F12 or Ctrl+Shift+I)
  3. Go to Storage → Cookies → select https://x.com
  4. Find and copy these two values:
    • auth_token — long hex string (e.g. a1b2c3d4...)
    • ct0 — 160-character hex string
spectre add myaccount "auth_token=a1b2c3d4...; ct0=e5f6a7b8..."

Tip: ct0 is exactly 160 hex characters. Double-check you copied the full value — partial cookies will fail silently.

3. Configure Your MCP Client

Add to your MCP client config (~/.hermes/config.yaml, claude_desktop_config.json, .cursor/mcp.json, or equivalent):

{
在 GitHub 查看完整 README

安装

uvx spectre-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "spectre": { "command": "uvx", "args": ["spectre-mcp"] } } }