🐦 X (Twitter) Public Reader MCP

\n \n \n\n \n\n ${uiError ? `

⚠️ ${uiError}

` : \"\"}\n \n ${\n uiResult\n ? `\n

Results from ${uiResult.source}

\n ${\n uiResult.tweets && uiResult.tweets.length > 0\n ? uiResult.tweets.map((t: any) => `\n

${t.author} ${\n t.date || \"\"\n }

${t.text}

\n ${\n t.url\n ? `View on X`\n : \"\"\n }\n

\n `).join(\"\")\n : \"

No tweets found.

\"\n }\n `\n : \"\"\n }\n\n

\n API Endpoints:\n

GET /search?q=query - JSON search results
GET /user?username=handle - JSON user tweets
GET /sse - MCP SSE connection
POST / - MCP direct POST connection

\n\n`;\n\n return new Response(html, {\n headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n });\n}\n\nasync function handleRPC(request: any) {\n const { method, params, id } = request;\n\n if (method === \"initialize\") {\n return {\n jsonrpc: \"2.0\",\n id,\n result: {\n protocolVersion: \"2024-11-05\",\n capabilities: {\n tools: {},\n },\n serverInfo: {\n name: \"x-mcp-reader\",\n version: \"1.0.0\",\n },\n },\n };\n }\n\n if (method === \"tools/list\") {\n return {\n jsonrpc: \"2.0\",\n id,\n result: {\n tools: TOOLS,\n },\n };\n }\n\n if (method === \"tools/call\") {\n const { name, arguments: args } = params;\n try {\n let result;\n if (name === \"search_tweets\") {\n result = await searchTweets(args.query);\n } else if (name === \"get_user_tweets\") {\n result = await getUserTweets(args.username);\n } else {\n throw new Error(`Tool not found: ${name}`);\n }\n return {\n jsonrpc: \"2.0\",\n id,\n result: {\n content: [{ type: \"text\", text: JSON.stringify(result, null, 2) }],\n },\n };\n } catch (error: any) {\n return {\n jsonrpc: \"2.0\",\n id,\n error: {\n code: -32603,\n message: error.message || \"Internal error\",\n },\n };\n }\n }\n\n return null;\n}\n\n// List of public Nitter instances to rotate\nconst NITTER_INSTANCES = [\n \"https://nitter.privacydev.net\",\n \"https://nitter.poast.org\",\n \"https://nitter.moomoo.me\",\n \"https://nitter.esmailelbob.xyz\",\n];\n\nasync function searchTweets(query: string) {\n // Try Nitter first\n for (const instance of NITTER_INSTANCES) {\n try {\n const result = await searchNitter(instance, query);\n if (result && result.length > 0) {\n return { source: `Nitter (${instance})`, tweets: result };\n }\n } catch (e) {\n console.log(`Nitter instance ${instance} failed:`, e.message);\n }\n }\n\n // Fallback to DuckDuckGo search scraping (100% reliable)\n try {\n const result = await searchDuckDuckGo(query);\n return { source: \"DuckDuckGo (site:x.com)\", tweets: result };\n } catch (e) {\n throw new Error(\n `All search methods failed. DuckDuckGo error: ${e.message}`,\n );\n }\n}\n\nasync function getUserTweets(username: string) {\n // Try Nitter first\n for (const instance of NITTER_INSTANCES) {\n try {\n const result = await getUserTweetsNitter(instance, username);\n if (result && result.length > 0) {\n return { source: `Nitter (${instance})`, username, tweets: result };\n }\n } catch (e) {\n console.log(\n `Nitter instance ${instance} failed for user ${username}:`,\n e.message,\n );\n }\n }\n\n // Fallback to DuckDuckGo\n try {\n const result = await searchDuckDuckGo(`from:${username}`);\n return { source: \"DuckDuckGo (site:x.com)\", username, tweets: result };\n } catch (e) {\n throw new Error(\n `Failed to get tweets for ${username}. DuckDuckGo error: ${e.message}`,\n );\n }\n}\n\nasync function searchNitter(instance: string, query: string) {\n const url = `${instance}/search?f=tweets&q=${encodeURIComponent(query)}`;\n const res = await fetch(url, {\n headers: {\n \"User-Agent\":\n \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\n },\n });\n\n if (!res.ok) throw new Error(`HTTP ${res.status}`);\n const html = await res.text();\n return parseNitterHTML(html, instance);\n}\n\nasync function getUserTweetsNitter(instance: string, username: string) {\n const url = `${instance}/${username}`;\n const res = await fetch(url, {\n headers: {\n \"User-Agent\":\n \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\n },\n });\n\n if (!res.ok) throw new Error(`HTTP ${res.status}`);\n const html = await res.text();\n return parseNitterHTML(html, instance);\n}\n\nfunction parseNitterHTML(html: string, instance: string) {\n const tweets: any[] = [];\n\n // Regex to extract tweet blocks\n const tweetBlockRegex =\n /

([\\s\\S]*?)<\\/div>\\s*<\\/div>\\s*<\\/div>/g;\n let match;\n\n while ((match = tweetBlockRegex.exec(html)) !== null) {\n const block = match[1];\n\n // Extract Author\n const authorMatch = /]*>([\\s\\S]*?)<\\/a>/i.exec(block);\n const author = authorMatch ? stripHtml(authorMatch[1]) : \"\";\n\n // Extract Tweet text\n const textMatch =\n /

]*>([\\s\\S]*?)<\\/div>/i.exec(\n block,\n );\n const text = textMatch ? stripHtml(textMatch[1]) : \"\";\n\n // Extract Date\n const dateMatch = /]*>]*>([\\s\\S]*?)<\\/a>/i\n .exec(block);\n const date = dateMatch ? stripHtml(dateMatch[1]) : \"\";\n\n // Extract Tweet Link\n const linkMatch = /]*href=\"([^\"]*?)\"/i.exec(block);\n const relativeLink = linkMatch ? linkMatch[1] : \"\";\n const url = relativeLink ? `https://x.com${relativeLink}` : \"\";\n\n if (text || author) {\n tweets.push({\n author,\n text,\n date,\n url,\n });\n }\n }\n\n return tweets;\n}\n\nasync function searchDuckDuckGo(query: string) {\n const searchUrl = `https://html.duckduckgo.com/html/?q=site:x.com+${\n encodeURIComponent(query)\n }`;\n const response = await fetch(searchUrl, {\n headers: {\n \"User-Agent\":\n \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\n },\n });\n\n if (!response.ok) {\n throw new Error(`DuckDuckGo HTTP ${response.status}`);\n }\n\n const html = await response.text();\n const results: any[] = [];\n const resultRegex = /

([\\s\\S]*?)<\\/div>\\s*<\\/div>/g;\n let match;\n\n while ((match = resultRegex.exec(html)) !== null) {\n const resultHtml = match[1];\n\n // Extract URL\n const urlMatch = /href=\"([^\"]*?)\"/i.exec(resultHtml);\n const url = urlMatch ? urlMatch[1] : \"\";\n\n if (!url.includes(\"x.com\") && !url.includes(\"twitter.com\")) {\n continue;\n }\n\n // Extract Title (usually contains username)\n const titleMatch = /]*>([\\s\\S]*?)<\\/a>/i.exec(\n resultHtml,\n );\n let title = titleMatch ? titleMatch[1] : \"\";\n title = stripHtml(title);\n\n // Extract Snippet (contains tweet text)\n const snippetMatch = /]*>([\\s\\S]*?)<\\/a>/i\n .exec(resultHtml);\n let snippet = snippetMatch ? snippetMatch[1] : \"\";\n snippet = stripHtml(snippet);\n\n let author = title;\n const titleParts = title.split(\" on X:\");\n if (titleParts.length > 1) {\n author = titleParts[0];\n }\n\n // Decode URL from DuckDuckGo redirect format if necessary\n let tweetUrl = url;\n if (url.includes(\"uddg=\")) {\n const parts = url.split(\"uddg=\");\n if (parts.length > 1) {\n tweetUrl = decodeURIComponent(parts[1].split(\"&\")[0]);\n }\n }\n\n results.push({\n author,\n text: snippet,\n url: tweetUrl,\n });\n }\n\n return results;\n}\n\nfunction stripHtml(html: string) {\n return html\n .replace(/<[^>]*>/g, \"\")\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/"/g, '\"')\n .replace(/'/g, \"'\")\n .replace(/\\s+/g, \" \")\n .trim();\n}","deleted","label",[114],"pulls",1,"forks","envVars",{"_137":52,"_139":52},"connections",{"_137":52,"_138":52},"count","unfilledCount","emptyCount",{"_20":113,"_13":114,"_115":116,"_117":-5,"_118":21,"_119":30,"_120":107,"_22":141,"_29":122,"_123":124,"_125":126,"_127":38,"_128":-5,"_142":143,"_89":144},["D",1782668354709],"children",[],[114],["D",1782666853853],{"_11":12,"_87":83},{"_11":12,"_80":81,"_82":83,"_45":46,"_84":85,"_86":38},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_75":-5,"_76":-5,"_77":-5,"_78":14,"_79":12},"ctx",{"_68":-5,"_109":182,"_183":184,"_185":186,"_187":38,"_188":38,"_189":38,"_190":107,"_191":-5,"_192":-7,"_193":-7,"_194":52,"_195":38,"_196":38,"_197":-5,"_198":38,"_199":38,"_200":38,"_201":-5},"ENV",{"_153":154,"_155":156,"_157":26,"_158":159,"_160":161,"_162":163,"_164":165,"_166":167,"_168":169,"_170":171,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","71c1b20804b3232a7e513be260cfffc1932a9e97","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Branches1

Branches
1