{
  "markdown": "# Twitter Scraper API\n\n[![MCP Server](https://img.shields.io/badge/MCP-server-blue)](https://twitter-scraper.api.klymax402.com/mcp)\n[![x402](https://img.shields.io/badge/payments-x402-6E56CF)](https://x402.org)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\nScrape Twitter/X profiles, tweets, and search results. No API key needed. Returns structured JSON with bio, stats, tweets, engagement metrics. The social intelligence layer for AI agents. Pay-per-call via [x402](https://x402.org) (USDC on Base L2) -- no API key, no signup, no rate-limit wall.\n\nPart of the [klymax402](https://klymax402.com) marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.\n\n## Quickstart -- MCP\n\nAdd to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"twitter-scraper\": {\n      \"url\": \"https://twitter-scraper.api.klymax402.com/mcp\"\n    }\n  }\n}\n```\n\n## Quickstart -- HTTP (x402)\n\n```bash\ncurl -X POST \"https://twitter-scraper.api.klymax402.com/api/profile\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"username\":\"...\"}'\n# -> 402 Payment Required, with an x402 payment challenge in the response body\n```\n\nAny x402-aware client ([`@x402/fetch`](https://www.npmjs.com/package/@x402/fetch), [`x402-agent-tools`](https://www.npmjs.com/package/x402-agent-tools), ATXP) handles the 402 -> sign -> retry cycle automatically.\n\n## Tools\n\n| Tool | Method | Path | Price | Description |\n|---|---|---|---|---|\n| `twitter_scrape_profile` | POST | `/api/profile` | $0.012 | Scrape a Twitter/X user profile -- bio, stats, avatar, banner, pinned tweet, verification status. |\n| `twitter_search_tweets` | POST | `/api/search` | $0.012 | Search Twitter/X for tweets matching a query -- returns up to 20 results with text, engagement, author, and timestamps. |\n| `twitter_get_user_tweets` | POST | `/api/tweets` | $0.012 | Get recent tweets from a specific Twitter/X user -- returns their latest posts with engagement metrics. |\n\n### `twitter_scrape_profile`\n\nUse this when you need to look up a Twitter/X user profile by username or URL. Returns structured profile data including bio, follower/following counts, tweet count, verification status, and recent activity.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `username` | string | yes | Twitter/X username without @ (e.g. 'elonmusk') or full URL (e.g. 'https://x.com/elonmusk') |\n\n**Returns**\n\n- `username` -- the @handle\n- `displayName` -- full name\n- `bio` -- profile description text\n- `followers` -- follower count\n- `following` -- following count\n- `tweetCount` -- total tweets posted\n- `verified` -- blue checkmark status\n- `createdAt` -- account creation date\n- `avatarUrl` -- profile picture URL\n- `bannerUrl` -- header image URL\n- `location` -- stated location\n- `website` -- linked URL\n- `pinnedTweet` -- text of pinned tweet if any\n\nExample response:\n\n```json\n{ \"username\": \"elonmusk\", \"displayName\": \"Elon Musk\", \"bio\": \"...\", \"followers\": 195000000, \"following\": 850, \"tweetCount\": 45000, \"verified\": true, \"createdAt\": \"2009-06-02\" }\n```\n\n**When to use**: social media due diligence, influencer research, competitor monitoring, or verifying the legitimacy of an account before trusting its content.\n\n**Not for**: tweet search (use `twitter_search_tweets`), trust/security scoring (use `trust_score_evaluate`), email lookup from social (use `email_find_by_name`).\n\n### `twitter_search_tweets`\n\nUse this when you need to find tweets about a topic, brand, event, or keyword. Returns up to 20 recent tweets matching the query with full text, engagement metrics, author info, and timestamps.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `query` | string | yes | Search query -- supports keywords, phrases, hashtags (#), mentions (@), and operators (from:user, since:2026-01-01) |\n| `count` | number | no | Number of tweets to return (1-20, default 10) |\n\n**Returns**\n\n- `query` -- the search term used\n- `results` -- array of tweet objects\n- `resultCount` -- number of tweets found\n\nExample response:\n\n```json\n{ \"query\": \"x402 protocol\", \"resultCount\": 15, \"results\": [{ \"id\": \"1234567890\", \"text\": \"x402 is the future of agent payments...\", \"author\": { \"username\": \"web3dev\", \"displayName\": \"Web3 Dev\" }, \"likes\": 42, \"retweets\": 12, \"replies\": 5, \"views\": 1200, \"createdAt\": \"2026-04-13T09:30:00Z\" }] }\n```\n\n**When to use**: market sentiment analysis, brand monitoring, competitor tracking, news discovery, trend detection, or finding what people say about a topic in real-time.\n\n**Not for**: profile data (use `twitter_scrape_profile`), sentiment analysis of text (use `text_analyze_sentiment`), crypto news (use `crypto_get_news`).\n\n### `twitter_get_user_tweets`\n\nUse this when you need to see what a specific Twitter/X user has been posting recently. Returns their latest tweets with full text, engagement metrics, and timestamps.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `username` | string | yes | Twitter/X username without @ (e.g. 'VitalikButerin') |\n| `count` | number | no | Number of tweets to return (1-20, default 10) |\n\n**Returns**\n\n- `username` -- the @handle queried\n- `tweets` -- array of tweet objects with id, text, createdAt, likes, retweets, replies, views, isRetweet, isReply\n- `tweetCount` -- number of tweets returned\n\nExample response:\n\n```json\n{ \"username\": \"VitalikButerin\", \"tweetCount\": 10, \"tweets\": [{ \"id\": \"...\", \"text\": \"Excited about the new EIP proposal...\", \"likes\": 5200, \"retweets\": 890, \"views\": 250000, \"createdAt\": \"2026-04-12T14:00:00Z\", \"isRetweet\": false }] }\n```\n\n**When to use**: monitoring specific accounts, tracking influencer activity, analyzing posting patterns, or gathering content from thought leaders.\n\n**Not for**: profile bio/stats (use `twitter_scrape_profile`), topic search (use `twitter_search_tweets`), social profile lookup across platforms (use `social_lookup_profile`).\n\n## Example agent prompts\n\n- \"Look up a Twitter/X user profile by username or URL\"\n- \"Find tweets about a topic, brand, event, or keyword\"\n- \"See what a specific Twitter/X user has been posting recently\"\n\n## Payment\n\n- Protocol: [x402](https://x402.org) -- HTTP-native pay-per-call, no signup, no API key\n- Network: Base L2 (`eip155:8453`)\n- Asset: USDC\n- Facilitator: Coinbase CDP (primary), PayAI (fallback)\n- Also reachable via [ATXP](https://atxp.ai) (OAuth-wrapped x402, RFC 9728 protected-resource metadata)\n\n## Part of klymax402\n\n100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.\n\n- Catalog: https://klymax402.com/llms.txt\n- Full API reference: https://klymax402.com/llms-full.txt\n- Live stats: https://klymax402.com/stats\n\n## License\n\nMIT\n",
  "bytes": 6756,
  "sha": "d8019242d86b42dd60414874989e11bce445164d97afd9c93cd260864ef1ee02",
  "repo_slug": "br0ski777/twitter-scraper-x402",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_br0ski777_twitter_scraper_ddfea8a1/readme"
}