feat: add x_read_post tool for full rich tweet reading with recursive quote tweets

[nj-io]

Summary

New scrapePost() function and x_read_post MCP tool that reads any tweet URL with full rich data and recursive quote tweet resolution.

What it does

Give it any tweet URL. It returns:

• Thread detection — if the author replied to themselves, all thread tweets are returned (not replies to others)
• Rich data per tweet — text (full, including note_tweets >280 chars), media (images + best-quality video MP4 URL), X Articles (title + cover + URL), cards (link previews with title/description/URL), external URLs (Substack, GitHub, etc. — filtered from entities), engagement stats
• Recursive quote tweets — if a tweet quotes another tweet, that quoted tweet is fetched as its own focal tweet (to get its full data, thread, and its own quote tweets). Recurses up to 5 levels deep.

Example: 3-level deep recursive resolution

@brian_blum1 — single post about Medvi marketing
  └─ quotes @pitdesi — 4-tweet THREAD
       Tweet 1: skepticism + quotes @sarthakgh
       Tweet 2: "said I wanted to be 60 lbs" + photo
       Tweet 3: "FDA compliance issue" + 2 photos
       Tweet 4: "800+ fake doctors" + photo
       └─ quotes @sarthakgh — NYT article quote
            └─ card: nytimes.com article link

Return shape

{
  "thread": [
    {
      "id": "...", "author": "...", "text": "...",
      "timestamp": "...", "url": "...",
      "media": [{ "type": "photo", "url": "..." }],
      "article": { "id": "...", "title": "...", "coverImage": "...", "url": "..." },
      "card": { "title": "...", "description": "...", "url": "...", "image": "..." },
      "urls": [{ "url": "https://open.substack.com/...", "display": "..." }],
      "replies": 14, "retweets": 5, "likes": 228, "views": "40642",
      "quotedPost": {
        "thread": [ ...same shape, recursively... ]
      }
    }
  ]
}

Architecture

• scrapePost() in src/scrapers/twitter/index.js
• Uses shared helpers from scrapeThread rewrite: fetchTweetDetail, parseTweetResult, parseThreadFromEntries
• Wired through src/scrapers/index.js → src/mcp/local-tools.js → src/mcp/server.js

Depends on

• feat: rewrite scrapeThread to use TweetDetail GraphQL API #17 — scrapeThread GraphQL rewrite (provides the shared helpers this PR uses)

Test plan

• Single post with quote tweet (Brian/pitdesi/sarthakgh) — 3 levels deep, cards, photos
• Thread with quote tweet (Aakash — 2 tweets + Grummz QT with photos)
• Thread quoting an X Article (MetaMorpehus — article title + Substack URL in thread tweet 2)
• 3-level nesting with videos (PeptideList → a16z → latentspacepod)
• Complex nesting: thread quoting thread quoting thread (neural_avb → Prince_Canuma → MaziyarPanahi)
• Single tweet with card (Karpathy follow-up — llm-wiki GitHub link + quotes original)
• 15-tweet thread (Breedlove — peptides thread with photos and video)

🤖 Generated with Claude Code

[vercel]

@nj-io is attempting to deploy a commit to the kaivocmenirehtacgmailcom's projects Team on Vercel.

A member of the Team first needs to authorize it.

[nj-io]

Superseded — resubmitting as clean PRs from current codebase.