Integrations

Overview

Captapi plugs straight into your AI tooling. The official @captapi/mcp server exposes all 178 endpoints as typed tools over the Model Context Protocol, so Claude, Cursor, VS Code, and any MCP-compatible agent can pull transcripts, comments, profiles, search results, and more — billed to your account, with cached results free.

Prefer a one-click setup? Open Agent Integrations in your dashboard for install buttons with your key pre-filled. Agents can read the machine-readable manifest at /mcp.json.

Not using MCP? The same 178 endpoints are also available as typed TypeScript & Python SDKs, a CLI, an n8n community node— or call the REST API directly.

MCP Server

There are two ways to connect — both expose the same 178 tools. Pick Hosted for the fastest setup (no install), or Local if you prefer running the package on your machine. Replace the key with your own from API Keys, then restart the client.

Option A — Hosted (no install, just a URL)

Connect over HTTP to https://api.captapi.com/mcp. Nothing to install — your key is passed as an Authorization header (or x-api-key). Ideal for agents that can't run local processes.

// ~/.cursor/mcp.json  (or .cursor/mcp.json per project)
{
  "mcpServers": {
    "captapi": {
      "url": "https://api.captapi.com/mcp",
      "headers": { "Authorization": "Bearer capt_live_xxxxxxxxxxxxxxxx" }
    }
  }
}

Paste this into the agent

For Claude Code, Codex, OpenClaw, or Hermes — no JSON file. Paste the paragraph; the agent installs itself.

Set up Captapi so I can fetch social media data (transcripts, comments, profiles, ads) from this chat.

1. Connect the hosted MCP at https://api.captapi.com/mcp. Ask me for a capt_live_… key if you do not have one.
2. If this client cannot use a URL, install locally: npx -y @captapi/mcp with CAPTAPI_API_KEY set.
3. Confirm the tools load (youtube_transcript, facebook_profile_posts, google_ad_library_company_ads).
4. Tell me when it's ready.

Option B — Local (npx / stdio)

Run the official @captapi/mcp package via npx. It talks to your client over stdio and reads your key from the CAPTAPI_API_KEY environment variable.

// ~/.cursor/mcp.json  (or .cursor/mcp.json per project)
{
  "mcpServers": {
    "captapi": {
      "command": "npx",
      "args": ["-y", "@captapi/mcp"],
      "env": { "CAPTAPI_API_KEY": "capt_live_xxxxxxxxxxxxxxxx" }
    }
  }
}

Configuration (local mode)

Tools & Parameters

Each endpoint is a tool named platform_action. Required parameters are marked *. The agent fills these in for you.

Typed SDKs (TypeScript & Python)

Writing code? The official SDKs cover every endpoint with typed, namespaced methods — great autocomplete for humans and AI coding agents — and errors always throw, never silently return empty data. TypeScript: @captapi/sdk (zero dependencies, Node 18+/Deno/Bun/edge). Python: pip install captapi (sync + async clients on httpx).

// TypeScript — npm install @captapi/sdk
import { Captapi } from "@captapi/sdk";
const client = new Captapi({ apiKey: "capt_live_..." });
const res = await client.youtube.transcript({ url: "https://youtube.com/watch?v=..." });

# Python — pip install captapi
from captapi import Captapi
client = Captapi(api_key="capt_live_...")
res = client.youtube.transcript(url="https://youtube.com/watch?v=...")

Platform features (batch, monitors, history, status)

Beyond single calls, the API ships building blocks competitors make you assemble yourself:

• Batch — POST /v1/batch runs up to 20 endpoint calls concurrently in one request, with per-item status and billing (cached items stay free).
• Monitors + webhooks — POST /v1/monitors watches any list endpoint (subreddit posts, channel videos, ad-library searches…) on your schedule and POSTs only new items to your webhook, HMAC-signed. Test deliveries with POST /v1/monitors/{id}/test.
• Metric history — GET /v1/history returns follower/view/like time series that accumulate automatically whenever tracked profile or post endpoints are fetched fresh.
• Live status — GET /v1/status (no auth) exposes per-platform success rates from real traffic; the human view lives at /status.

Command-line (CLI)

Prefer the terminal, a shell script, or CI? The official @captapi/cli package exposes all 178 endpoints as commands. Authenticate once with captapi login (or set CAPTAPI_API_KEY), then call any endpoint — each one is a subcommand, parameters are flags, and responses print as JSON to stdout so they pipe cleanly into jq and scripts. It can even wire the MCP server into your agent with captapi agent add.

npm install -g @captapi/cli      # or just use: npx @captapi/cli <command>

captapi login                    # paste your capt_live_… key (saved to ~/.captapi/config.json)
captapi whoami                   # confirm the active key
captapi balance                  # remaining credits + recent requests

Workflow automation (n8n)

Building no-code/low-code automations? The official n8n-nodes-captapi community node brings all 178 endpoints into n8n. Install it from Settings → Community Nodes, add a Captapi API credential with your capt_live_… key, then drop the Captapi node into any workflow — pick a platform and operation, and pipe the structured JSON into your other nodes.

# In n8n: Settings → Community Nodes → Install
n8n-nodes-captapi

# Self-hosted (npm), then restart n8n:
npm install n8n-nodes-captapi

Make.com — not in the public directory

There is no published Captapi app on Make.com (make.com/en/integrations/captapi is 404). Searching Make for Captapi will not find anything. Use n8n, MCP, or the REST API instead.

Apify — not in the public store

There is no Captapi Actor in the public Apify Store. Searching the store will not find one. Use n8n, MCP, or the REST API instead.