social-media-api-skills: social media API skills for AI agents
A social media API toolkit for AI agents. These skills let Claude, ChatGPT, Cursor, or any custom agent loop read public data from 33 platforms — the TikTok API for video transcripts, the Instagram API for reels and hashtags, the LinkedIn API for profiles and company data, the YouTube API for transcripts and comments, plus Reddit, X, Facebook, Amazon, Google and more — through one key and one JSON envelope. There is also a hosted MCP server if you would rather install nothing at all.
227 endpoints across 33 platforms
Free to start: signing up gives you 100 credits, no card required. Plain Node.js. No dependencies. MIT-0 licensed.
Install
Most people want the catch-all skill — one skill that reaches all 33 platforms:
# OpenClaw (via ClawHub)
npx clawhub@latest install social-media-api
# Hermes Agent
hermes skills install skills-sh/nikhonit/social-media-api-skills/skills/social-media-api
# Generic agent skills (Claude Code, Cursor, Cline) — installs every skill in the repo
npx skills add nikhonit/social-media-api-skills
Or install one platform, when you already know which you need. Every platform skill is on ClawHub under a scrapersocial- prefixed slug:
npx clawhub@latest install scrapersocial-tiktok
npx clawhub@latest install scrapersocial-instagram
npx clawhub@latest install scrapersocial-linkedin
npx clawhub@latest install scrapersocial-twitter
npx clawhub@latest install scrapersocial-reddit
npx clawhub@latest install scrapersocial-threads
npx clawhub@latest install scrapersocial-facebook
npx clawhub@latest install scrapersocial-amazon
npx clawhub@latest install scrapersocial-app-store
npx clawhub@latest install scrapersocial-bluesky
npx clawhub@latest install scrapersocial-github
npx clawhub@latest install scrapersocial-google
npx clawhub@latest install scrapersocial-google-finance
npx clawhub@latest install scrapersocial-google-maps
npx clawhub@latest install scrapersocial-google-news
npx clawhub@latest install scrapersocial-google-play
npx clawhub@latest install scrapersocial-google-shopping
npx clawhub@latest install scrapersocial-google-trends
npx clawhub@latest install scrapersocial-hacker-news
npx clawhub@latest install scrapersocial-kwai
npx clawhub@latest install scrapersocial-linkme
npx clawhub@latest install scrapersocial-linktree
npx clawhub@latest install scrapersocial-naver
npx clawhub@latest install scrapersocial-pinterest
npx clawhub@latest install scrapersocial-polymarket
npx clawhub@latest install scrapersocial-snapchat
npx clawhub@latest install scrapersocial-spotify
npx clawhub@latest install scrapersocial-tiktok-shop
npx clawhub@latest install scrapersocial-tripadvisor
npx clawhub@latest install scrapersocial-trustpilot
npx clawhub@latest install scrapersocial-truth-social
npx clawhub@latest install scrapersocial-twitch
npx skills add nikhonit/social-media-api-skills installs every skill in the repo at once. The per-platform skills carry argument
validation, per-endpoint costs and guidance on when not to spend credits; the
catch-all trades that for reach.
Skills in this repo
| Skill | Platform | Endpoints | What it covers |
|---|
| amazon-api | Amazon | 4 | Product detail, product search, reviews and seller listings. |
| app-store-api | App Store | 6 | App metadata, reviews, keyword search and category charts. |
| bluesky-api | Bluesky | 3 | Public profiles, post timelines and keyword search. |
| facebook-api | Facebook | 23 | Transcripts, page stats, comments, reels, ads, marketplace and events. |
| github-api | GitHub | 11 | Repos, commits, contributors, issues, releases, profiles and trending. |
| google-api | Google | 5 | Search results, Business Profile info, reviews and company ads. |
| google-finance-api | Google Finance | 3 | Quotes, historical price history and instrument search. |
| google-maps-api | Google Maps | 4 | Place details, place search, photos and contact discovery. |
|
Quickstart
# 1. Get a key — 100 free credits, no card
open https://scrapersocial.com/signup
# 2. Export it
export SCRAPERSOCIAL_KEY=sk_live_...
# 3. Run any script
node skills/github-api/scripts/get_profile.js torvalds
Note: no captured sample output is committed yet. The response shape shown below is taken from the OpenAPI spec — it is not a recorded call. Run SCRAPERSOCIAL_KEY=... node tools/capture.mjs to record real output and regenerate.
Every response uses the same envelope:
{
"data": {},
"meta": { "count": 20, "next_cursor": "..." },
"request_id": "a18e4ef88ad4b00b"
}
data is an object for single-entity endpoints and an array for paginated ones. meta appears on paginated responses only. Keep request_id — it is how support traces a call.
Errors follow the same discipline:
{
"error": {
"code": "invalid_url",
"message": "...",
"hint": "...",
"request_id": "..."
}
}
Failed calls are not charged.
Works with
These are plain Node scripts with a documented contract, so anything that can run a command can use them.
- Claude Code / Claude Skills — install with
npx skills add nikhonit/social-media-api-skills
- ChatGPT — expose a script as a function or run it in a code interpreter step
- Cursor, Cline, Windsurf — drop the repo in and let the agent read
SKILL.md
- Any agent loop — call the scripts as subprocesses and parse stdout
Zero install: the hosted MCP server
If you would rather not vendor anything, ScraperSocial runs a hosted MCP server that reaches the same endpoints:
Claude.ai: Settings → Connectors → Add custom connector → https://mcp.scrapersocial.com (OAuth, no key to paste). Full per-client instructions, including Windsurf, Gemini CLI and ChatGPT, are at https://scrapersocial.com/mcp/.
claude mcp add --transport http scrapersocial https://mcp.scrapersocial.com
{
"mcpServers": {
"scrapersocial": {
"url": "https://mcp.scrapersocial.com",
"headers": { "Authorization": "Bearer sk_live_..." }
}
}
}
It exposes 14 tools — twelve capability tools (get_transcript, get_summary, get_post_stats, get_comments, get_comment_replies, get_profile, get_channel_posts, search, search_hashtag, get_reviews, download_media, get_trending) plus list_endpoints and call_endpoint, which between them reach the entire surface. Auth is OAuth 2.1 PKCE or a bearer key.
Use the skills in this repo when you want per-platform guidance, argument validation, and control over exactly which endpoint runs. Use the MCP server when you want nothing installed.
What you get back
- Clean JSON, one envelope for every platform
request_id on every response, including errorsx-cache: hit|miss header telling you whether it came from cache- Projection and format control —
fields trims the response, format switches between json, csv and ndjson
- OpenAPI 3.1: scrapersocial.com/openapi.json
- Agent-readable summary: llms.txt · llms-full.txt
Every endpoint is GET https://api.scrapersocial.com/v1/{platform}/{capability}. Optional parameters on every call:
| Param | Effect |
|---|
limit | Items on paginated endpoints. Default 20. Scripts clamp this to 50 — above that the API returns an async job instead of data. |
cursor | next_cursor from a previous response's meta. |
fields | Projection, e.g. fields=id,author.name. |
format | json (default), csv, ndjson. |
fresh | true bypasses the cache at the same credit cost. |
Authentication
Every script reads one environment variable:
export SCRAPERSOCIAL_KEY=sk_live_...
Manage keys at scrapersocial.com/app/keys. The scripts never print your key — error output carries the request_id instead. Keep it out of source control.
Pricing
| Plan | Price | Credits | Rate limit |
|---|
| Free | $0 | 100 one-time at signup, no card | 20/min |
| Monthly | $5/mo | 1,000/month, top-ups $4/1k | 200/min |
| Annual | $54/yr | 12,000 upfront, top-ups $3/1k | 300/min |
| Enterprise | custom | custom | 1,500/min |
Credits are charged per item returned on paginated endpoints and per call otherwise. Costs range from 1 credit (GitHub, Hacker News, Bluesky, Linktree) to 42 (Instagram AI summary). Each skill's SKILL.md lists the exact cost of every endpoint it wraps. Cache hits cost the same as fresh calls and return in milliseconds. Failed calls are not charged.
FAQ
How do I get TikTok data as JSON?
Install tiktok-api, export SCRAPERSOCIAL_KEY, and run node skills/tiktok-api/scripts/get_transcript.js <video-url>. It returns the spoken content as JSON for 8 credits. Channel stats, comments, hashtag search and song lookups are separate scripts in the same skill.
Is there a free social media API?
This one starts free: 100 credits at signup with no card. That covers roughly 100 GitHub or Hacker News calls, or a dozen TikTok transcripts. After that, plans start at $5/month for 1,000 credits.
How do I give Claude access to LinkedIn data?
Two ways. Install the linkedin-api skill from this repo, or add the hosted MCP server with claude mcp add --transport http scrapersocial https://mcp.scrapersocial.com. Both cover profiles, companies, job and people search, posts and the ad library.
What is an MCP server for social media?
An MCP server exposes tools an AI agent can call directly, without you writing glue code. ScraperSocial's is at https://mcp.scrapersocial.com and exposes 14 tools covering all 33 platforms. Add it once and the agent can read social data on its own.
Can I transcribe an Instagram reel with an API?
Yes — node skills/instagram-api/scripts/get_transcript.js <reel-url>, 40 credits. An AI summary of the same reel costs 42. TikTok transcripts are 8 credits and YouTube transcripts are 3, so check which platform you actually need.
How much does it cost?
Between 1 and 42 credits per call depending on the endpoint, with credits from $3–5 per thousand. GitHub, Hacker News, Bluesky and Linktree are 1 credit. Video transcripts and AI summaries are the expensive end. Every SKILL.md lists exact per-endpoint costs.
Is this an official TikTok, Instagram or LinkedIn API?
No. ScraperSocial is an independent product, not affiliated with any platform named here, and returns publicly available data only. Where a platform offers its own API — GitHub, Spotify, Reddit, Bluesky — that is often free and richer; these skills are most useful for the platforms that do not, and for using one key across all of them.
Do the skills work without Node?
They need Node 20 or newer, because they use built-in fetch. There are no other dependencies and no build step. If you would rather not run Node at all, use the hosted MCP server.
Issues and contributions
Bug reports and pull requests are welcome at github.com/nikhonit/social-media-api-skills.
Note that skills/ and manifest.json are generated — edit tools/content/*.md and run node tools/generate.mjs. See CONTRIBUTING.md.
For API questions or a key problem, email [email protected] with the request_id from the response.
License
MIT No Attribution (MIT-0). Use these however you like, no attribution required.
Disclaimer
ScraperSocial is an independent product and is not affiliated with, endorsed by, or sponsored by any platform named in this repository. All product names, logos and brands are property of their respective owners. These skills return only publicly available data.
