InsightSocial

npx add-mcp 'https://api.insightsocial.app/mcp'

insightsocial

El CLI oficial y servidor MCP para la API de InsightSocial: datos públicos en vivo de 25 plataformas con una sola clave: Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads, Pinterest, Bluesky, Truth Social, Snapchat, Telegram, Twitch, Kick, Rumble, Kwai, Douyin, Xiaohongshu (RedNote), Quora, TikTok Shop, Weibo, Zhihu, Substack y Nextdoor.

• Más de 300 endpoints: perfiles, correos públicos, publicaciones, reels, comentarios, seguidores, likes, hashtags, búsqueda, páginas de empresa, empleos, anuncios, transcripciones, productos de tienda y listados de negocios locales.
• Un solo esquema en todas las plataformas: un video de TikTok y una publicación de Instagram devuelven los mismos campos (post.url, post.kind, post.engagement.likes, post.language), y unavailable lista cualquier campo que una respuesta no pudo completar. El CLI y el servidor MCP solicitan esquema 2 en cada llamada.
• Precio por endpoint, cobro por llamada. Resultados vacíos, llamadas fallidas y reproducciones idempotentes son gratuitas.
• Diseñado para agentes. Cada resultado se guarda completo, y puedes re-procesarlo localmente con jq de forma gratuita, de modo que una página de 50 KB nunca termine en tu contexto.

Inicio rápido

npx -y insightsocial init              # sign in through your browser, install the agent skill, show MCP setup
npx -y insightsocial search instagram followers
npx -y insightsocial run /v1/instagram/profile -p handle=natgeo
npx -y insightsocial view --last --jq '.data.author | {username, followers}'

init y login te inician sesión a través de tu navegador: abren la página de inicio de sesión e imprimen un código corto, escribes el código allí y haces clic en Permitir, y se guarda una clave con el nombre de esta máquina. El CLI luego imprime en qué cuenta inició sesión. Para usar una clave que ya tienes, pasa --api-key. Las cuentas nuevas incluyen llamadas gratuitas.

Úsalo desde un agente de IA

Plugin de Claude Code

/plugin marketplace add insightsocial/skills
/plugin install insightsocial@insightsocial

Esto instala la habilidad y el servidor MCP juntos, desde insightsocial/skills. Ejecuta npx -y insightsocial login una vez para que el servidor pueda encontrar tu clave.

Servidor MCP (cualquier cliente)

claude mcp add insightsocial --scope user -- npx -y insightsocial mcp

{
  "mcpServers": {
    "insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }
  }
}

El servidor lee la clave guardada por insightsocial login, por lo que la configuración no contiene secretos. También puedes pasar INSIGHTSOCIAL_API_KEY en su env. Sin una clave, la búsqueda y la descripción siguen funcionando.

Nada que instalar: las mismas herramientas están alojadas en https://api.insightsocial.app/mcp. Claude, ChatGPT y otros clientes que lo soportan inician sesión con OAuth; otros envían la clave como Authorization: Bearer. Consulta documentación de MCP.

Herramienta	Qué hace
search_endpoints	Encuentra endpoints por palabras clave y plataforma. Gratis.
describe_endpoint	Entradas, valores permitidos, un ejemplo y el precio de un endpoint. Gratis.
call_endpoint	Obtiene datos. Guarda la respuesta completa y devuelve un result_id con una vista recortada (10 elementos por defecto) y un next_call listo para la siguiente página.
read_result	Re-procesa un resultado guardado con jq, campos, max_items o un esquema con tamaños. Gratis.
get_credits	Saldo, plan y uso. Gratis.

insightsocial init --yes escribe la entrada de MCP en Claude Code, Codex y Cursor por ti.

Comandos

Comando
init [--yes] [--no-skills]	Guarda una clave, instala la habilidad para agentes detectados, imprime o escribe la configuración de MCP.
login [--api-key k] [--no-browser] / logout	Inicia sesión a través de tu navegador (o guarda una clave que pases) / elimina la clave.
search <words> [--platform p]	Encuentra endpoints. Gratis.
list [--platform p]	Cada endpoint con su precio. Gratis.
describe <path>	Entradas, ejemplo y precio. Gratis.
run <path> -p name=value …	Llama a un endpoint. Guarda en ./.insightsocial/. Opciones: --input <json>, -i file, --idempotency-key, --fresh, --max-credits N, -o file, --json, y las banderas de formato a continuación.
view [file] [--last [endpoint]]	Re-formatea un resultado guardado. Sin red, sin cargo.
credits	Saldo y uso. Gratis.
mcp	Inicia el servidor MCP sobre stdio.

Banderas de formato (run y view) recortan solo lo que se imprime; el archivo guardado siempre está completo:

• --jq <expr>: jq real (incluido, nada que instalar) sobre la respuesta guardada. Las rutas comienzan en .data.
• --fields a,b.c: conserva estas claves en cada elemento. Las rutas con puntos descienden.
• --max-items N: muestra como máximo N elementos.
• --summary: la estructura con tamaños en bytes, para que puedas ver qué es grande antes de extraerlo.

Paginación: cuando hay otra página, run imprime el comando exacto de next. Cada página es una llamada separada con cargo.

Cotizar una llamada primero: -p dry_run=1 (o true) en cualquier endpoint devuelve la cotización y no cobra nada. Cuando una respuesta no pudo completar un campo que la plataforma normalmente tiene, run lo imprime bajo missing; ese null significa desconocido, no cero.

Configuración

Clave	--api-key, luego INSIGHTSOCIAL_API_KEY, luego ~/.insightsocial/config.json (modo 600)
INSIGHTSOCIAL_BASE_URL	Por defecto https://api.insightsocial.app
INSIGHTSOCIAL_HOME	Por defecto ~/.insightsocial (config, caché de catálogo, resultados de MCP)

Desarrollo

npm install
npm run check      # build + unit tests, no network and no key needed

Licencia

MIT