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

src/mcp/local-tools.js

@@ -20,6 +20,7 @@ import {
   scrapeTweets,
   searchTweets,
   scrapeThread,
+  scrapePost,
   scrapeLikes,
   scrapeMedia,
   scrapeListMembers,
@@ -202,6 +203,11 @@ export async function x_get_thread({ url }) {
   return scrapeThread(pg, url);
 }
 
+export async function x_read_post({ url }) {
+  const { page: pg } = await ensureBrowser();
+  return scrapePost(pg, url);
+}
+
 export async function x_best_time_to_post({ username, limit = 100 }) {
   const { page: pg } = await ensureBrowser();
   const tweets = await scrapeTweets(pg, username, { limit });
@@ -1346,6 +1352,7 @@ export const toolMap = {
   x_get_tweets,
   x_search_tweets,
   x_get_thread,
+  x_read_post,
   x_best_time_to_post,
   // Core actions
   x_follow,

src/mcp/server.js

@@ -1129,6 +1129,17 @@ const TOOLS = [
       required: ['url'],
     },
   },
+  {
+    name: 'x_read_post',
+    description: 'Read a tweet/post with full rich data. Returns thread if the post is part of one (author self-replies only). Recursively resolves quoted tweets — if a quoted tweet is itself a thread or contains its own quote tweet, those are fetched too. Each tweet includes: text, media (images + video URLs), X Articles, cards (link previews), external URLs, and engagement stats.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'URL of the tweet/post' },
+      },
+      required: ['url'],
+    },
+  },
   // ====== Posting Analytics ======
   {
     name: 'x_best_time_to_post',

src/scrapers/index.js

@@ -79,6 +79,7 @@ export const {
   scrapeTweets,
   searchTweets,
   scrapeThread,
+  scrapePost,
   scrapeLikes,
   scrapeHashtag,
   scrapeMedia,
@@ -308,6 +309,7 @@ export default {
   scrapeTweets,
   searchTweets,
   scrapeThread,
+  scrapePost,
   scrapeLikes,
   scrapeHashtag,
   scrapeMedia,