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.

<!-- generated:counts -->

227 endpoints across 33 platforms

<!-- /generated:counts -->

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

<!-- generated:skills -->

| 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. | | google-news-api | Google News | 1 | Keyword search across news headlines and sources. | | google-play-api | Google Play | 4 | Android app metadata, reviews, keyword search and categories. | | google-shopping-api | Google Shopping | 1 | Product search across merchants, with pricing. | | google-trends-api | Google Trends | 2 | Interest over time and rising related queries. | | hacker-news-api | Hacker News | 4 | Stories, comment threads, user profiles and keyword search. | | instagram-api | Instagram | 23 | Reel transcripts, profile and post stats, comments, hashtags and locations. | | kwai-api | Kwai | 3 | Creator profiles, post listings and single video lookups. | | linkedin-api | LinkedIn | 38 | Profiles and 20 sub-resources, companies, job and people search, posts and ads. | | linkme-api | Linkme | 1 | Resolve a Linkme page to its links and profile details. | | linktree-api | Linktree | 1 | Resolve a Linktree page to its links and profile details. | | naver-api | Naver | 4 | Blog, cafe, local and shopping search across Korea's main portal. | | pinterest-api | Pinterest | 3 | Pin details, keyword search and per-URL save counts. | | polymarket-api | Polymarket | 1 | Prediction market listings and current odds. | | reddit-api | Reddit | 8 | Posts, comment threads, subreddit listings, user profiles and search. | | snapchat-api | Snapchat | 1 | Public creator profile lookups. | | spotify-api | Spotify | 6 | Tracks, albums, artists, top tracks, playlists and search. | | threads-api | Threads | 5 | Profiles, post timelines, post stats and keyword search. | | tiktok-api | TikTok | 16 | Transcripts, summaries, channel stats, comments, hashtag and song search. | | tiktok-shop-api | TikTok Shop | 5 | Product detail, reviews, shop catalogues and creator showcases. | | tripadvisor-api | Tripadvisor | 2 | Hotel, restaurant and attraction search with review listings. | | trustpilot-api | Trustpilot | 1 | Company review listings. | | truth-social-api | Truth Social | 2 | Public profiles and user post timelines. | | twitch-api | Twitch | 3 | Streamer profiles, clips and video listings. | | twitter-api | X (Twitter) | 7 | Transcripts, AI summaries, post stats, profiles, tweets and search. | | youtube-api | YouTube | 26 | Transcripts, captions, video and channel stats, comments, Shorts and search. | | social-media-api | All platforms | 227 | Discover and call any documented endpoint across every source, social and web. |

<!-- /generated:skills -->

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

<!-- generated:sample -->

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.

<!-- /generated:sample -->

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 errors
• x-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