socialscrapelisted
Install: claude install-skill SocialScraper/socialscrape-skills
# SocialScrape
One API for social media data. Every platform answers in the same shape
(`Profile`, `Post`, `Comment`, `Song`, `Ad`, `Transcript`, `ListPage`). You pay in credits per
successful request; failures cost nothing.
## Pick the way in
1. **MCP tools** (if `get_transcript`, `search`, `get_profile` are in your tool list): use them. A tool
per platform (`github`, `facebook`, ...) takes a `resource` argument. `describe` shows exact
parameters for free.
2. **CLI** (`socialscrape`, if installed): `socialscrape <platform> <resource> <value>`. Data on
stdout, the price on stderr. `--dry-run` shows the request and cost without sending it.
3. **HTTP**: `GET https://api.socialscrape.dev/v1/<platform>/<resource>?...` with header
`x-api-key: $SOCIALSCRAPE_API_KEY`. Every response is an envelope: `ok`, `data`, `credits_charged`,
`credits_remaining`, `cached`, `cursor`, `has_more`, `request_id`.
A key looks like `ss_live_...`. It comes from the user's dashboard (https://socialscrape.dev/app).
Never print it, log it or put it in a file you create. If there is no key, ask the user for one
rather than guessing.
## Think about credits before you call
- A profile, a post, one page of a list, a caption transcript: **1 credit**. AI transcription (no
captions exist): 1 credit up to 2 minutes of audio, then 5 per started minute of the whole video,
with `allow_long_transcription=true`.
- **Free**: `get_credits`, `describe`, `get_job`, usage history, anything that fai