🐦 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}","label",[63],"pulls","branches","forks","envVars",{"_192":20,"_194":20},"connections",{"_192":20,"_193":20},"count","unfilledCount","emptyCount",{"_32":177,"_13":63,"_61":62,"_42":-5,"_34":35,"_178":101,"_179":171,"_36":196,"_38":94,"_64":84,"_181":182,"_66":24,"_183":-5,"_197":198,"_154":199},["D",1782668354709],"children",[],[63],["D",1782666853853],{"_11":12,"_153":69},{"_11":12,"_148":149,"_68":69,"_25":67,"_150":151,"_152":24},{"_38":101,"_13":16,"_32":35,"_140":106,"_141":-5,"_142":-5,"_143":-5,"_144":-5,"_145":-5,"_146":14,"_147":12},"ctx",{"_50":-5,"_173":237,"_238":239,"_240":241,"_242":24,"_243":24,"_244":24,"_245":171,"_246":-5,"_247":-7,"_248":-7,"_249":20,"_250":24,"_251":24,"_252":-5,"_253":24,"_254":24,"_255":24,"_256":-5},"ENV",{"_208":209,"_210":211,"_212":16,"_213":214,"_215":216,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226,"_227":228,"_229":230,"_231":232,"_233":234,"_235":236},"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"]

History