feat: add x_get_likes (GraphQL) and x_discover_likes with human-like deep reads

src/mcp/local-tools.js

@@ -20,6 +20,9 @@ import {
   scrapeTweets,
   searchTweets,
   scrapeThread,
+  scrapePost,
+  scrapeLikedTweets,
+  discoverLikes,
   scrapeLikes,
   scrapeMedia,
   scrapeListMembers,
@@ -202,6 +205,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 });
@@ -630,6 +638,16 @@ export async function x_get_bookmarks({ limit = 100 }) {
   return scrapeBookmarks(pg, { limit });
 }
 
+export async function x_get_likes({ username, limit = 50, from, to }) {
+  const { page: pg } = await ensureBrowser();
+  return scrapeLikedTweets(pg, username, { limit, from, to });
+}
+
+export async function x_discover_likes({ username, limit = 50, from, to }) {
+  const { page: pg } = await ensureBrowser();
+  return discoverLikes(pg, username, { limit, from, to });
+}
+
 export async function x_clear_bookmarks() {
   const { page: pg } = await ensureBrowser();
   await pg.goto('https://x.com/i/bookmarks', { waitUntil: 'networkidle2' });
@@ -1346,6 +1364,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,
@@ -1369,6 +1388,8 @@ export const toolMap = {
   x_reply,
   x_bookmark,
   x_get_bookmarks,
+  x_get_likes,
+  x_discover_likes,
   x_clear_bookmarks,
   x_auto_like,
   // Discovery

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',
@@ -1903,12 +1914,28 @@ const TOOLS = [
   },
   {
     name: 'x_get_likes',
-    description: 'Scrape tweets that a user has liked. Shows what content a user engages with.',
+    description: 'Scrape liked tweets via GraphQL API with rich data. Writes results to a JSONL file. Supports timestamp filtering.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        username: { type: 'string', description: 'Username (without @)' },
+        limit: { type: 'number', description: 'Maximum liked tweets (default: 50)' },
+        from: { type: 'string', description: 'Only include likes from this date onward (e.g. "2026-03-01")' },
+        to: { type: 'string', description: 'Only include likes up to this date (e.g. "2026-03-31")' },
+      },
+      required: ['username'],
+    },
+  },
+  {
+    name: 'x_discover_likes',
+    description: 'Fetch liked tweets and deep-read each one with human-like pacing. Produces two JSONL files: a likes index and deep reads (full thread/quote tweet data per tweet). Long-running — check JSONL files on disk for progress.',
     inputSchema: {
       type: 'object',
       properties: {
         username: { type: 'string', description: 'Username (without @)' },
         limit: { type: 'number', description: 'Maximum liked tweets (default: 50)' },
+        from: { type: 'string', description: 'Only include likes from this date onward' },
+        to: { type: 'string', description: 'Only include likes up to this date' },
       },
       required: ['username'],
     },
@@ -2275,7 +2302,7 @@ async function executeTool(name, args) {
   const xeepyTools = [
     'x_get_replies', 'x_get_hashtag', 'x_get_likers', 'x_get_retweeters',
     'x_get_media', 'x_get_recommendations', 'x_get_mentions', 'x_get_quote_tweets',
-    'x_get_likes', 'x_auto_follow', 'x_follow_engagers', 'x_unfollow_all',
+    'x_auto_follow', 'x_follow_engagers', 'x_unfollow_all',
     'x_smart_unfollow', 'x_quote_tweet', 'x_auto_comment', 'x_auto_retweet',
     'x_detect_bots', 'x_find_influencers', 'x_smart_target', 'x_crypto_analyze',
     'x_grok_analyze_image', 'x_audience_insights', 'x_engagement_report',
@@ -2475,22 +2502,6 @@ async function executeXeepyTool(name, args) {
       return { quotes, count: quotes.length };
     }
 
-    case 'x_get_likes': {
-      const page = await localTools.getPage();
-      await page.goto(`https://x.com/${args.username}/likes`, { waitUntil: 'networkidle2', timeout: 30000 });
-      await new Promise(r => setTimeout(r, 3000));
-      const likedTweets = await page.evaluate((limit) => {
-        const articles = document.querySelectorAll('article[data-testid="tweet"]');
-        return Array.from(articles).slice(0, limit).map(el => {
-          const textEl = el.querySelector('[data-testid="tweetText"]');
-          const userEl = el.querySelector('[data-testid="User-Name"]');
-          const timeEl = el.querySelector('time');
-          return { text: textEl?.textContent || '', author: userEl?.textContent || '', timestamp: timeEl?.getAttribute('datetime') || '' };
-        });
-      }, args.limit || 50);
-      return { likedTweets, count: likedTweets.length, username: args.username };
-    }
-
     // ── Follow Automation ──
     case 'x_auto_follow': {
       // Find users via search, then follow them with delays

src/scrapers/index.js

@@ -79,6 +79,9 @@ export const {
   scrapeTweets,
   searchTweets,
   scrapeThread,
+  scrapePost,
+  scrapeLikedTweets,
+  discoverLikes,
   scrapeLikes,
   scrapeHashtag,
   scrapeMedia,
@@ -308,6 +311,9 @@ export default {
   scrapeTweets,
   searchTweets,
   scrapeThread,
+  scrapePost,
+  scrapeLikedTweets,
+  discoverLikes,
   scrapeLikes,
   scrapeHashtag,
   scrapeMedia,