🐦 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",[108],"pulls","branches",1,"forks","envVars",{"_132":40,"_134":40},"connections",{"_132":40,"_133":40},"count","unfilledCount","emptyCount",{"_18":107,"_20":108,"_109":110,"_111":-5,"_112":66,"_113":64,"_114":101,"_22":136,"_63":116,"_117":118,"_119":120,"_121":26,"_122":-5,"_137":138,"_84":139},["D",1782668354709],"children",[],[108],["D",1782666853853],{"_16":17,"_82":78},{"_16":17,"_75":76,"_77":78,"_33":34,"_79":80,"_81":26},{"_63":64,"_20":65,"_18":66,"_67":19,"_68":-5,"_69":-5,"_70":-5,"_71":-5,"_72":-5,"_73":21,"_74":17},"ctx",{"_56":-5,"_103":177,"_178":179,"_180":181,"_182":26,"_183":26,"_184":26,"_185":101,"_186":-5,"_187":-7,"_188":-7,"_189":40,"_190":26,"_191":26,"_192":-5,"_193":26,"_194":26,"_195":26,"_196":-5},"ENV",{"_148":149,"_150":151,"_152":65,"_153":154,"_155":156,"_157":158,"_159":160,"_161":162,"_163":164,"_165":166,"_167":168,"_169":170,"_171":172,"_173":174,"_175":176},"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"]

Search