InsightSocial

app.insightsocialv0.1.0Updated Oct 3, 2026

Live public data from Instagram, TikTok, LinkedIn, YouTube, X and 4 more networks, via one key.

VerifiedSTDIODesktop onlyWeb Search & ScrapingData & AnalyticsCommunication & Collaboration

Overview

AI-generated overview

Lets an assistant search and call 239 paid InsightSocial endpoints for live public social media data across nine networks.

What it does
Exposes the InsightSocial API as MCP tools: search_endpoints and describe_endpoint find and explain endpoints for free, call_endpoint fetches data and saves the full response while returning a trimmed view with a result_id, read_result re-slices saved results locally with jq, and get_credits reports balance and usage. It covers profiles, public emails, posts, reels, comments, followers, likers, hashtags, search, company pages, jobs, ads and transcripts, with one shared schema across platforms.
When to use it
Use it when an assistant needs live public data from Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads or Pinterest, such as profile lookups, engagement metrics, hashtag or keyword search, or transcripts. It suits agent workflows that want to inspect large responses locally instead of loading them into context.
Requirements
Runs locally over stdio via npx (Node.js required). An InsightSocial API key is needed for data calls, supplied through the INSIGHTSOCIAL_API_KEY environment variable, the --api-key option, or the config file written by login; search and describe work without a key. Network access to the InsightSocial API is required, and the key is checked against the service.
Before you install
Calls are billed per endpoint and charged per call, so costs accrue with use; each page of results is a separate charged call. The server handles a secret API key (INSIGHTSOCIAL_API_KEY) and stores it in a config file. It fetches third-party public data from social platforms, and saved results are written to a local directory.

Installation

In SourceWeft

  1. Open InsightSocial in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

insightsocial

The official CLI and MCP server for the InsightSocial API: live public data from Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads and Pinterest through one key.

  • 239 endpoints: profiles, public emails, posts, reels, comments, followers, likers, hashtags, search, company pages, jobs, ads and transcripts.
  • One schema across platforms: a TikTok video and an Instagram post come back with the same fields (post.url, post.engagement.likes, computed.engagement_rate).
  • Priced per endpoint, charged per call. Empty results, failed calls and idempotent replays are free.
  • Built for agents. Every result is saved in full, and you re-slice it locally with jq for free, so a 50 KB page never ends up in your context.

Quick start

sh
npx -y insightsocial init              # save your key, install the agent skill, show MCP setupnpx -y insightsocial search instagram followersnpx -y insightsocial run /v1/instagram/profile -p handle=natgeonpx -y insightsocial view --last --jq '.data.author | {username, followers}'

Get a key at https://www.insightsocial.app/portal/api/keys. New accounts include free calls.

Use it from an AI agent

Claude Code plugin

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

This installs the skill and the MCP server together, from insightsocial/skills. Run npx -y insightsocial login once so the server can find your key.

MCP server (any client)

sh
claude mcp add insightsocial --scope user -- npx -y insightsocial mcp
json
{  "mcpServers": {    "insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }  }}

The server reads the key saved by insightsocial login, so the config holds no secret. You can also pass INSIGHTSOCIAL_API_KEY in its env. Without a key, search and describe still work.

ToolWhat it does
search_endpointsFind endpoints by keywords and platform. Free.
describe_endpointInputs, allowed values, an example and the price for one endpoint. Free.
call_endpointFetch data. Saves the full response and returns a result_id with a trimmed view (10 items by default) and a ready next_call for the next page.
read_resultRe-slice a saved result with jq, fields, max_items or an outline with sizes. Free.
get_creditsBalance, plan and usage. Free.

insightsocial init --yes writes the MCP entry into Claude Code, Codex and Cursor for you.

Commands

Command
init [--yes] [--no-skills]Save a key, install the skill for detected agents, print or write the MCP config.
login [--api-key k] / logoutSave (after checking it) or remove your key.
search <words> [--platform p]Find endpoints. Free.
list [--platform p]Every endpoint with its price. Free.
describe <path>Inputs, example and price. Free.
run <path> -p name=value …Call an endpoint. Saves to ./.insightsocial/. Options: --input <json>, -i file, --idempotency-key, --fresh, --max-credits N, -o file, --json, and the shaping flags below.
view [file] [--last [endpoint]]Re-shape a saved result. No network, no charge.
creditsBalance and usage. Free.
mcpStart the MCP server over stdio.

Shaping flags (run and view) trim only what is printed; the saved file is always complete:

  • --jq <expr>: real jq (bundled, nothing to install) over the saved response. Paths start at .data.
  • --fields a,b.c: keep these keys on each item. Dotted paths descend.
  • --max-items N: show at most N items.
  • --summary: the structure with byte sizes, so you can see what is large before pulling it.

Paging: when there is another page, run prints the exact next command. Each page is a separate charged call.

Configuration

Key--api-key, then INSIGHTSOCIAL_API_KEY, then ~/.insightsocial/config.json (mode 600)
INSIGHTSOCIAL_BASE_URLDefaults to https://api.insightsocial.app
INSIGHTSOCIAL_HOMEDefaults to ~/.insightsocial (config, catalogue cache, MCP results)

Develop

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

License

MIT

Source: README.md at commit 59881fe

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.0LatestOct 3, 2026