ExportComments MCP server
Commit Oct 21, 2026Exports comments and reviews from over 40 social media and e-commerce platforms for AI-driven analysis and automation.
Also known as exportcomments/exportcomments-cli
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 21, 2026
- License
- MIT
What is ExportComments MCP?
ExportComments exports comments and reviews from over 40 social media and e-commerce platforms for AI-driven analysis and automation. It exposes 13 tools, such as export_comments, check_export, list_exports.
Summary generated from the project's README
About ExportComments MCP server
Extracting social media comments and e-commerce reviews for automated analysis is what this tool enables. It provides a command-line interface and an MCP server that connects to the ExportComments.com API, allowing users to pull data from over 40 platforms including Instagram, YouTube, Amazon, and TikTok. Developers can use it locally via npm or npx, requiring an API token set as an environment variable for authentication.
AI agents using Claude, Cursor, or Windsurf can access fifty specialized tools to manage data. These tools include capabilities for creating export jobs, checking job status, and downloading results in JSON or CSV formats. Beyond simple extraction, the server provides server-side insights like sentiment distribution, keyword searching, and statistical reports without needing to move large datasets. It also supports giveaway management by picking random winners based on specific filters like mentions or hashtags.
What you can do with it
- 1Analyze social media sentimentAsk an AI agent to calculate the sentiment distribution and net score of comments from a specific URL.
- 2Automate giveaway winner selectionInstruct your AI client to pick random winners from a comment thread using specific hashtag or mention filters.
- 3Perform bulk data extractionRequest the extraction of comments from a large list of URLs to be processed as a single batch job.
- 4Compare engagement across exportsHave an AI assistant identify differences in author churn or metric changes between two different data exports.
Written from the project's README. Every use case is checked against a quote from it.
ExportComments MCP tools 13
Detected from the READMEexport_commentscheck_exportlist_exportsdownload_exportexport_diagnosticsexport_statssearch_exportsample_exportexport_sentimentcompare_exportsexport_analytics_reportpick_random_winners
| export_comments | — | |
| check_export | — | |
| list_exports | — | |
| download_export | — | |
| export_diagnostics | — | |
| export_stats | — | |
| search_export | — | |
| sample_export | — | |
| export_sentiment | — | |
| compare_exports | — | |
| export_analytics_report | — | |
| pick_random_winners | — |
Show all 13 toolsShow fewer tools
publish_giveaway_result
| publish_giveaway_result | — |
Configuration
EXPORTCOMMENTS_API_TOKEN
| Name | Description | |
|---|---|---|
| EXPORTCOMMENTS_API_TOKEN | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableexportcomments/exportcomments-cli is public and reachablegithub.com/exportcomments/exportcomments-cli ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-21github.com/exportcomments/exportcomments-cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubExportComments CLI & MCP Server
Command-line tool and MCP server for the ExportComments.com API. Export comments and reviews from 40+ social media and review platforms.
Designed for AI agent usage - includes an MCP server for native AI integration (Claude, Cursor, Windsurf) and a CLI with structured JSON output.
Installation
npm install -g exportcomments-cli
Or use directly with npx:
npx exportcomments-cli export https://www.instagram.com/p/ABC123/
Authentication
Get your API token at app.exportcomments.com/user/api.
# Set as environment variable (recommended)
export EXPORTCOMMENTS_API_TOKEN="your-token-here"
# Or pass with each command
exportcomments --token "your-token-here" export https://...
Commands
export - Create an export job
# Basic export
exportcomments export https://www.instagram.com/p/ABC123/
# With options
exportcomments export https://www.youtube.com/watch?v=dQw4w9WgXcQ --replies --limit 500
# Wait for completion and download
exportcomments export https://www.amazon.com/dp/B08N5WRWNW --wait --download
# Get raw JSON data
exportcomments export https://www.trustpilot.com/review/example.com --wait --download-json
# Filter by date range
exportcomments export https://www.reddit.com/r/sub/comments/abc123/ --min-date 2024-01-01 --max-date 2024-06-30
# Twitter/X specific
exportcomments export https://x.com/username --tweets --followers --limit 1000
Options:
| Flag | Description |
|---|---|
--replies |
Include replies to comments |
--limit <n> |
Maximum number of items to export |
--min-date <date> |
Start date filter (ISO 8601) |
--max-date <date> |
End date filter (ISO 8601) |
--vpn <country> |
Use VPN with specified country |
--cookies <json> |
Cookies as JSON string |
--tweets |
Include tweets (Twitter/X) |
--followers |
Export followers (Twitter/X) |
--following |
Export following list (Twitter/X) |
--likes |
Export likes |
--shares |
Include shares data |
--advanced |
Enable advanced export features |
--facebook-ads |
Include Facebook ads data |
--wait |
Wait for completion (polls every 5s) |
--wait-interval <ms> |
Custom polling interval |
--wait-timeout <ms> |
Custom timeout (default: 600000) |
--download |
Download file when done (implies --wait) |
--download-json |
Download raw JSON when done (implies --wait) |
status - Check job status
exportcomments status <guid>
# Wait for completion
exportcomments status <guid> --wait
list - List export jobs
exportcomments list
exportcomments list --page 2 --limit 10
download - Download export file
# Download formatted file (Excel/CSV)
exportcomments download <guid>
# Download raw JSON data
exportcomments download <guid> --json
platforms - List supported platforms
# List all platforms
exportcomments platforms
# Detect platform from URL
exportcomments platforms --detect "https://www.youtube.com/watch?v=abc"
# Get specific platform info
exportcomments platforms --id instagram
ping - Check API connectivity
exportcomments ping
Output Format
All commands output JSON with a consistent envelope:
// Success
{
"ok": true,
"data": { ... }
}
// Error
{
"ok": false,
"error": "Human-readable error message",
"error_code": "MACHINE_READABLE_CODE",
"detail": "Additional context"
}
Supported Platforms
| Category | Platforms |
|---|---|
| Social Media | Instagram, YouTube, TikTok, Facebook, Twitter/X, LinkedIn, Reddit, Threads, VK |
| Video | YouTube, Vimeo, Twitch |
| Messaging | Discord |
| E-commerce | Amazon, AliExpress, Shopee, Lazada, Flipkart, Etsy, Walmart, Best Buy, eBay |
| Reviews | Trustpilot, Yelp, Google Reviews, TripAdvisor, IMDb |
| App Stores | Apple App Store, Google Play Store |
| Other | Disqus, Product Hunt, Airbnb, Steam, Change.org |
Job Statuses
| Status | Description |
|---|---|
queueing |
Job is queued for processing |
progress |
Job is being processed |
done |
Job completed successfully |
error |
Job failed with an error |
MCP Server (for AI Agents)
The MCP server gives AI assistants (Claude, Cursor, Windsurf, etc.) native access to ExportComments tools.
Setup with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"exportcomments": {
"command": "npx",
"args": ["-y", "--package", "exportcomments-cli", "exportcomments-mcp"],
"env": {
"EXPORTCOMMENTS_API_TOKEN": "your-token-here"
}
}
}
}
The package ships two binaries —
exportcomments-cli(CLI) andexportcomments-mcp(MCP stdio server). The--package … exportcomments-mcpform tellsnpxto installexportcomments-clibut execute the MCP binary inside it, so the process stays alive and serves MCP over stdio.
Setup with Claude Code
claude mcp add exportcomments -- npx -y --package exportcomments-cli exportcomments-mcp
Available MCP Tools
Fifty tools, three resources and seven guided prompts. Everything marked all tiers works on Free and Personal plans too.
Exports
| Tool | Description |
|---|---|
export_comments |
Create an export job for a URL (supports wait / realtime) |
check_export |
Job status by GUID, optionally waiting for completion |
list_exports |
List export jobs with pagination |
download_export |
Full data of a finished export — JSON for Premium/Business, CSV for Free/Personal |
export_many_urls / check_batch_export |
Bulk: one job per URL in a batch, one ZIP at the end |
retry_export / stop_export |
Retry a failed job, stop a running one |
export_diagnostics |
Status, customer-safe error, warnings, cap-by-limit detection, next-step hint |
detect_platform / list_platforms |
Platform detection and the full platform catalogue |
Server-side insights (all tiers; the dataset never leaves the server, so these work on 50k-comment exports)
| Tool | Description |
|---|---|
export_stats |
Totals, per-day/hour/weekday, top authors / hashtags / mentions / words, likes and length distributions, sentiment and rating distributions |
search_export |
Filter rows by words, regex, author, likes, date range, sentiment, rating, links, questions; sort + paginate |
sample_export |
N rows: random (seedable), top_likes, latest, oldest, longest |
export_sentiment |
Sentiment distribution, net score and examples over a bounded subset |
compare_exports |
Diff two exports: added/removed comments, author churn, metric deltas |
export_analytics_report |
Dashboard analytics (heatmaps, engagement series) for profile/hashtag/channel exports |
Giveaways
| Tool | Description |
|---|---|
pick_random_winners |
Seeded, reproducible server-side draw with mention/hashtag/text/exclude/min-likes filters and a verification hash (all tiers) |
publish_giveaway_result |
Publish a winner to a public verification page and get its share URL |
Workflows (Premium/Business)
list_workflows, get_workflow, workflow_pipeline_info, create_workflow, update_workflow, delete_workflow, pause_workflow, resume_workflow, run_workflow — multi-step pipelines such as "latest posts of a profile → comments of each post".
Schedules and webhooks
list_schedules, create_schedule, update_schedule, delete_schedule, run_schedule, pause_schedule, resume_schedule, list_webhooks, create_webhook, update_webhook, delete_webhook, toggle_webhook, test_webhook.
Account
get_my_profile, get_my_quota, get_my_limits, get_usage_history, get_account_analytics, list_invoices, get_extra_capacity_checkout (returns a checkout link, never charges), get_export_notification, toggle_export_notification.
Resources
| URI | Content |
|---|---|
exportcomments://platforms |
Supported platforms reference |
exportcomments://exports |
The 20 most recent exports of the connected account |
exportcomments://export/{guid} |
One export: diagnostics + stats + a 10-row sample (GUID autocompletes) |
Prompts
analyze_export, client_report, pick_giveaway_winners, find_leads_and_questions, compare_two_exports, monitor_source, profile_posts_and_comments — guided recipes that appear as quick actions in MCP clients.
Run Directly
EXPORTCOMMENTS_API_TOKEN="your-token" exportcomments-mcp
CLI Usage
The CLI outputs structured JSON for scripting and automation.
Example AI workflow
# 1. Check what platform a URL belongs to
exportcomments platforms --detect "https://www.instagram.com/p/ABC123/"
# 2. Create an export and wait for it
exportcomments export "https://www.instagram.com/p/ABC123/" --replies --wait
# 3. If the export succeeded, download the raw data
exportcomments download <guid> --json
Development
git clone https://github.com/exportcomments/exportcomments-cli.git
cd exportcomments-cli
npm install
npm run build
# Run in development
npx tsx src/cli.ts --help
License
MIT
ExportComments MCP questions
What tools does ExportComments MCP provide?
It exposes 13 tools, including export_comments, check_export, list_exports, download_export, export_diagnostics.
Which platforms are supported?
The tool supports over 40 platforms including Instagram, YouTube, TikTok, Facebook, X (Twitter), Amazon, Trustpilot, and Google Reviews.
Does it provide sentiment analysis?
Yes, the server includes tools for sentiment distribution, net scores, and comparing sentiment across different exports.