Social media data in Codex
One line sets up the InsightSocial skill and MCP server in Codex and signs you in through the browser. Codex can then pull public data from 9 platforms into the project it is working on.
Connect Codex in 3 steps
- 1
Open Codex in the project you want it in
- 2
Paste this line and send it
Set up https://www.insightsocial.app/SKILL.md, then run `npx -y insightsocial init --yes` to connect my InsightSocial account
- 3
A sign-in page opens in your browser. Type the code Codex shows you, then click Allow.
Then ask Codex
Instagram
“Pull the last 20 reels from @nike and rank them by views.”
TikTok
“Get the transcript of this TikTok and turn it into a blog outline: tiktok.com/@…/video/…”
LinkedIn
“What does this company do, how many employees, and where is it based? linkedin.com/company/…”
YouTube
“How many subscribers does @mkbhd have, and what are his 10 latest uploads?”
Tools Codex gets
| Tool | What it does | Cost |
|---|---|---|
| search_endpoints | Find the right endpoint for a question, by keywords and platform | Free |
| describe_endpoint | Inputs, allowed values, an example and the price of one endpoint | Free |
| quote_endpoint | The exact price of a call before it is made | Free |
| call_endpoint | Fetch the data. Marked as a tool that spends, so your app asks before it runs | The endpoint's price |
| read_result | Re-read a saved result by fields, item count or outline, without calling again | Free |
| get_credits | Your balance, plan and usage | Free |
InsightSocial in Codex: frequently asked questions
1. Open Codex in the project you want it in. 2. Paste this line and send it. 3. A sign-in page opens in your browser. Type the code Codex shows you, then click Allow.
No. Codex signs in to your InsightSocial account through the browser and gets its own key, which you never see. New accounts include 10 free calls.
Searching, describing and pricing endpoints are free. Fetching data costs the endpoint's price in credits, and your first 10 calls priced at 100 credits or less are free. A call that errors or finds nothing costs 0. The free plan includes monthly credits, with no card needed.
The tool that fetches data is marked as one that spends, so MCP clients ask before running it. The assistant can also quote the exact price of a call first, for free.
Instagram, TikTok, Facebook, LinkedIn, Twitter/X, YouTube, Reddit, Threads, Pinterest: 237 endpoints for public profiles, posts, comments, followers, search, transcripts and ad libraries. Public data only; it never logs in as you on those platforms.
An app you connected by signing in gets its own key, listed under Connected apps on your API keys page: disconnect it there and it loses access straight away. A key you pasted into a config is revoked on the same page.