Skip to content

CLAUDE.md

Latest commit

 

History

History
62 lines (44 loc) · 1.5 KB

CLAUDE.md

File metadata and controls

62 lines (44 loc) · 1.5 KB
Raw

ExportComments CLI

A command-line tool for the ExportComments.com API. Designed for AI agent usage with structured JSON output.

Quick Start

export EXPORTCOMMENTS_API_TOKEN="your-token-here"
exportcomments export https://www.instagram.com/p/ABC123/ --wait

Architecture

  • src/cli.ts - CLI entry point with all commands (Commander.js)
  • src/mcp.ts - MCP server entry point (6 tools for AI agents)
  • src/client.ts - HTTP API client wrapping ExportComments v3 endpoints
  • src/platforms.ts - Platform metadata (33 platforms with URL patterns, options, examples)
  • src/types.ts - TypeScript type definitions

API

Base URL: https://exportcomments.com/api/v3 Auth header: X-AUTH-TOKEN: <token>

Endpoints

Method Path Description
POST /api/v3/job Create export job
GET /api/v3/job/{guid} Check job status
GET /api/v3/jobs List all jobs
GET /api/v3/job/{guid}/download Download export file
GET /api/v3/job/{guid}/json Download raw JSON
GET /api/v1/ping Health check

Output Format

All commands return JSON with this envelope:

{"ok": true, "data": { ... }}
{"ok": false, "error": "message", "error_code": "CODE", "detail": "..."}

Job Statuses

  • queueing - Job is queued
  • progress - Job is being processed
  • done - Job completed successfully
  • error - Job failed

Build

npm install && npm run build

Development

npx tsx src/cli.ts export https://...