xpoz
Social intelligence for AI agents - Twitter/X, Instagram, TikTok data access and insights. 1.5B+ posts indexed. No API keys, no installation - just add endpoint URL. Perfect for brand monitoring, competitive analysis, influencer research, and content analysis. ## Why Xpoz? π **Zero Setup** - No npm install, no Docker, no local dependencies. Add one URL to your config and go. π **No API Keys** - no rate limit management required. π **Comprehensive Data** - User profiles, posts, followers, following lists, engagement metrics, and sentiment analysis ready. π€ **CSV Export** - Bulk data export for large-scale analysis and reporting. π **OAuth 2.0 Authentication** - Secure Google authentication, no API keys to manage. π **1.5B+ Posts Indexed** - Including historical data. β‘ **Multi-Platform** - Query Twitter/X and Instagram from a single unified interface. ## What You Can Do **Twitter/X:** - Get user profiles, followers, following lists - Search tweets by keywords with boolean operators - Analyze engagement (comments, quotes, retweets) - Export full datasets to CSV **Instagram:** - Look up user profiles and statistics - Search posts by caption keywords - Get comments and engagement metrics - Analyze follower/following networks **TikTok** - coming soon ## Example Queries Just ask Claude naturally: - "Get @elonmusk's Twitter profile and recent tweets" - "Search for tweets about 'artificial intelligence' from last week" - "Find Instagram posts with #AIart and show engagement stats" - "Export all tweets mentioning 'OpenAI' to CSV" - "Compare follower counts between @nvidia and @amd" ## Use Cases - Brand monitoring & sentiment analysis - Competitive intelligence - Influencer research & verification - Content trend analysis - Social media analytics - OSINT research ## MCP Endpoint ``` https://mcp.xpoz.ai/mcp ``` ## Tags (comma-separated) ``` twitter, instagram, tiktok, social-media, analytics, osint, research, remote, data, intelligence, brand-moni
How to connect
https://xpoz--net-service.run.tools
tools/list returns the expected tools before relying on them in production.Tools
(27)-
getTwitterUserByIdGet Twitter user profile by numeric ID. Use when you have exact user ID. NOT for username - use getTwitterUserByUsername. Optional fields parameter for performance (default: ["id", "username", "name"]). Available fields: id, username, name, description, location, followersCount, followingCount, verified, profileImageUrl, and more. Returns: id, username, name, bio, followers_count, following_count, tweet_count, created_at, authenticity_score, inauthentic_type.
-
getTwitterUserByUsernameGet user profile by EXACT Twitter handle/username ONLY. CRITICAL: Use ONLY when you have the precise Twitter username (e.g., "elonmusk", "OpenAI"). DO NOT use for person names (e.g., "Elon Musk", "Sam Altman") - use searchTwitterUsers instead. DO NOT use for partial matches or fuzzy search - use searchTwitterUsers instead. When to use: User explicitly provides Twitter handle (@username), or you already know exact username from previous context. When NOT to use: Given person's name, searching by
-
searchTwitterUsersSearch users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Elon Musk", "Sam Altman"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getTwitterUserByUsername when username is certain). Optional fields parameter for performance (default: ["id", "username", "name"]). Available fields: id, username, name,
-
getTwitterFollowersGet all users that follow a Twitter user (who follows them) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds
-
getTwitterFollowingGet all users that a Twitter user is following (who they follow) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 se
-
getTwitterPostByIdGet single Twitter post by numeric ID. First searches database, then external API if not found. Use when you have exact post ID. NOT for search - use getTwitterPostsByKeywords. Optional fields parameter for performance: ["id", "text", "retweetCount"]. Returns: id, text, authorId, createdAt, metrics (retweets, replies, quotes).
-
getTwitterPostsByAuthorIdGet posts from author by numeric ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Downl
-
getTwitterPostsByAuthorUsernameGet posts from author by username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Downloa
-
getTwitterPostsByKeywordsSearch posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download CSV and
-
getTwitterPostRetweetsGet retweets of specific post with server-side pagination (100 posts per page, database-only). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTI
-
getTwitterPostQuotesGet quote posts of specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download
-
getTwitterPostCommentsGet comments (replies) to specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: D
-
countTweetsCount tweets containing a specific phrase within a date range. Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. Returns the total count of matching tweets (int), or zero if none found. QUERY SYNTAX: Use double quotes for exact phrase match (e.g., "climate crisis"). Without quotes, matches any word. ALWAYS use quotes when user requests exact count or specific
-
checkOperationStatusCheck status and retrieve results from background operations. Required: operationId. HANDLES TWO TYPES: (1) Query operations (op_toolname_xxx): returns paginated results + dataDumpExportOperationId. (2) Export operations (op_datadump_xxx): returns S3 signed URL for CSV download. CRITICAL: You MUST keep polling until operation finishes. DO NOT stop until status is completed/failed/cancelled. POLLING LOOP: (1) Call immediately after getting operation ID. (2) If status=running, wait exactly 5 secon
-
cancelOperationCancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationStatus to verify cancellation completed.
-
getInstagramPostByIdGet single Instagram post by ID. First searches database, then external API if not found or data is stale (>3 days). Use when you have exact post ID. Optional fields parameter for performance: ["id", "caption", "likeCount"]. Returns: id, caption, userId, username, createdAtDate, engagement metrics (likes, comments, reshares, video plays).
-
getInstagramPostsByUserIdGet posts by Instagram user ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download C
-
getInstagramPostsByUsernameGet posts by Instagram username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download
-
getInstagramPostsByKeywordsSearch Instagram posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Downlo
-
getInstagramUserByIdGet Instagram user profile by numeric ID. Use when you have exact user ID. NOT for username - use getInstagramUserByUsername. Optional fields parameter for performance (default: ["id", "username", "fullName"]). Available fields: id, username, fullName, biography, isPrivate, isVerified, followerCount, followingCount, mediaCount, profilePicUrl, and more. Returns: userId, username, fullName, followerCount, followingCount, mediaCount, biography, isVerified, isPrivate, profilePicUrl.
-
getInstagramUserByUsernameGet user profile by EXACT Instagram username ONLY. CRITICAL: Use ONLY when you have the precise Instagram username (e.g., "instagram", "cristiano"). DO NOT use for person names (e.g., "Cristiano Ronaldo") - use searchInstagramUsers instead. DO NOT use for partial matches or fuzzy search - use searchInstagramUsers instead. When to use: User explicitly provides Instagram username (@username), or you already know exact username from previous context. When NOT to use: Given person's name, searching
-
searchInstagramUsersSearch users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Cristiano Ronaldo", "Kim Kardashian"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getInstagramUserByUsername when username is certain). Optional fields parameter for performance (default: ["id", "username", "fullName"]). Available fields: i
-
getInstagramFollowersGet all users that follow an Instagram user (who follows them) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seco
-
getInstagramFollowingGet all users that an Instagram user is following (who they follow) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60
-
getInstagramCommentsByPostIdGet comments for an Instagram post with server-side pagination (100 comments per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Dow
-
getUserAccessKeyRetrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata.
-
checkAccessKeyStatusCheck access key status without revealing key. Required: authentication. Returns: status, metadata.