Skills
skills/merit-systems/agentcash-skills/social-scraping

social-scraping

SKILL.md

Social Media Scraping with StableSocial

Scrape profiles, posts, comments, followers, and search across TikTok, Instagram, Facebook, Reddit, and LinkedIn. All endpoints cost $0.06 per call.

Setup

See rules/getting-started.md for installation and wallet setup.

Notes

Use npx agentcash@latest fetch for paid POST triggers. Use npx agentcash@latest fetch for free GET polling.

IMPORTANT: Use exact endpoint paths from the Quick Reference tables below. All paths include a platform prefix (e.g. https://stablesocial.dev/api/tiktok/...).

How It Works: Async Two-Step Flow

Every request follows a trigger-then-poll pattern:

Step 1: Trigger (paid, $0.06)

npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "natgeo"}'

Returns 202 Accepted with a JWT token:

{"token": "eyJhbGciOiJIUzI1NiIs..."}

Step 2: Poll (free)

npx agentcash@latest fetch "https://stablesocial.dev/api/jobs?token=eyJhbGciOiJIUzI1NiIs..."
  • {"status": "pending"} — poll again in 3-5 seconds
  • {"status": "finished", "data": {...}} — data is ready
  • {"status": "failed", "error": "..."} — collection failed (not charged)

Tokens expire after 30 minutes. Jobs typically finish in 5-60 seconds.

Quick Reference — TikTok

Task Endpoint Depends On
Get profile https://stablesocial.dev/api/tiktok/profile —
Get posts https://stablesocial.dev/api/tiktok/posts profile
Post comments https://stablesocial.dev/api/tiktok/post-comments posts
Comment replies https://stablesocial.dev/api/tiktok/comment-replies post-comments
Followers https://stablesocial.dev/api/tiktok/followers profile
Following https://stablesocial.dev/api/tiktok/following profile
Search posts https://stablesocial.dev/api/tiktok/search —
Search hashtag https://stablesocial.dev/api/tiktok/search-hashtag —
Search profiles https://stablesocial.dev/api/tiktok/search-profiles —
Search by music https://stablesocial.dev/api/tiktok/search-music —

Input: {"handle": "username"} for profile/posts/followers. {"query": "keyword"} for search.

Quick Reference — Instagram

Task Endpoint Depends On
Get profile https://stablesocial.dev/api/instagram/profile —
Get posts https://stablesocial.dev/api/instagram/posts profile
Post comments https://stablesocial.dev/api/instagram/post-comments posts
Comment replies https://stablesocial.dev/api/instagram/comment-replies post-comments
Followers https://stablesocial.dev/api/instagram/followers profile
Following https://stablesocial.dev/api/instagram/following profile
Stories https://stablesocial.dev/api/instagram/stories profile
Highlights https://stablesocial.dev/api/instagram/highlights profile
Search posts https://stablesocial.dev/api/instagram/search —
Search tags https://stablesocial.dev/api/instagram/search-tags —

Input: {"handle": "username"} for profile/posts/followers. {"query": "keyword"} for search.

Quick Reference — Facebook

Task Endpoint Depends On
Get profile https://stablesocial.dev/api/facebook/profile —
Get posts https://stablesocial.dev/api/facebook/posts profile
Post comments https://stablesocial.dev/api/facebook/post-comments posts
Comment replies https://stablesocial.dev/api/facebook/comment-replies post-comments
Followers https://stablesocial.dev/api/facebook/followers profile
Following https://stablesocial.dev/api/facebook/following profile
Search posts https://stablesocial.dev/api/facebook/search —
Search people https://stablesocial.dev/api/facebook/search-people —
Search pages https://stablesocial.dev/api/facebook/search-pages —
Search groups https://stablesocial.dev/api/facebook/search-groups —

Input: {"handle": "username"} or {"profile_id": "id"} for profile. {"query": "keyword"} for search.

Quick Reference — Reddit

Task Endpoint Depends On
Get post https://stablesocial.dev/api/reddit/post —
Post comments https://stablesocial.dev/api/reddit/post-comments post
Get comment https://stablesocial.dev/api/reddit/comment —
Search posts https://stablesocial.dev/api/reddit/search —
Search profiles https://stablesocial.dev/api/reddit/search-profiles —
Subreddit posts https://stablesocial.dev/api/reddit/subreddit —

Input: {"post_id": "id"} for post details. {"query": "keyword"} for search. {"subreddit": "name"} for subreddit.

Quick Reference — LinkedIn

Task Endpoint Depends On
Member profile https://stablesocial.dev/api/linkedin/profile —
Member posts https://stablesocial.dev/api/linkedin/posts profile
Company profile https://stablesocial.dev/api/linkedin/company —
Company posts https://stablesocial.dev/api/linkedin/company-posts company
Post comments https://stablesocial.dev/api/linkedin/post-comments posts
Comment replies https://stablesocial.dev/api/linkedin/comment-replies post-comments
Post reactors https://stablesocial.dev/api/linkedin/post-reactors posts
Search posts https://stablesocial.dev/api/linkedin/search-posts —
Search jobs https://stablesocial.dev/api/linkedin/search-jobs —
Search members https://stablesocial.dev/api/linkedin/search-members —
Search companies https://stablesocial.dev/api/linkedin/search-companies —
Search ads https://stablesocial.dev/api/linkedin/search-ads —

Input: {"member_id": "username"} for profile. {"company_id": "company"} for company. {"query": "keyword"} for search.

Data Dependencies

Some endpoints require a prior collection. For example, to get followers you must first trigger the profile:

# 1. Trigger profile collection
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/profile -m POST -b '{"handle": "natgeo"}'
# Poll until finished...

# 2. Now fetch followers (depends on profile)
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/followers -m POST -b '{"handle": "natgeo"}'
# Poll until finished...

Pagination

When results are paginated, the response includes page_info.has_next_page and a cursor. Pass the cursor to fetch the next page (each page is a new paid POST):

npx agentcash@latest fetch https://stablesocial.dev/api/tiktok/followers -m POST -b '{"handle": "username", "cursor": "abc123"}'

Key Parameters

  • handle / profile_id / member_id / company_id — target account
  • max_page_size — results per page (default varies, max 100)
  • max_followers — how many followers to collect (default 500)
  • max_posts / max_activities / max_results — item limits (default 50)
  • cursor — pagination cursor from previous response
  • order_by — sort order: date_desc, date_asc, id_desc
  • activity_type — LinkedIn: posts, articles, documents, media, comments
  • reaction_type — LinkedIn: LIKE, CELEBRATE, SUPPORT, LOVE, INSIGHTFUL, FUNNY

Workflows

Profile Deep Dive

  • (Optional) Check balance: npx agentcash@latest wallet info
  • Trigger profile collection
  • Poll until finished
  • Trigger posts collection
  • Poll until finished
  • Optionally fetch comments, followers

Cross-Platform Search

  • Search same keyword across multiple platforms
  • Compare results and synthesize findings
npx agentcash@latest fetch https://stablesocial.dev/api/instagram/search -m POST -b '{"query": "brand name"}'
npx agentcash@latest fetch https://stablesocial.dev/api/tiktok/search -m POST -b '{"query": "brand name"}'
npx agentcash@latest fetch https://stablesocial.dev/api/reddit/search -m POST -b '{"query": "brand name"}'

Influencer Analysis

  • Get profile on target platform
  • Fetch recent posts with engagement
  • Get follower list for audience analysis
  • Check comments for sentiment

Competitive Intelligence

  • Search LinkedIn for competitor company
  • Get company posts and reactions
  • Search for competitor ads
  • Monitor employee activity
npx agentcash@latest fetch https://stablesocial.dev/api/linkedin/company -m POST -b '{"company_id": "competitor"}'
npx agentcash@latest fetch https://stablesocial.dev/api/linkedin/search-ads -m POST -b '{"query": "competitor name"}'

Cost Estimation

All endpoints are $0.06 per trigger call. Polling is free.

Task Calls Cost
Single profile 1 $0.06
Profile + posts 2 $0.12
Full profile deep dive 4-6 $0.24-0.36
Cross-platform search (3 platforms) 3 $0.18
Competitor analysis 4-8 $0.24-0.48

vs social-intelligence Skill

The social-intelligence skill uses Reddit (stableenrich.dev). Use it for quick Reddit post lookups and discussions.

Use social-scraping (this skill) when you need:

  • TikTok, Instagram, Facebook, or LinkedIn data
  • Profiles, followers, following — not just search
  • Comments, replies, reactions on posts
  • LinkedIn jobs, ads, company data
  • Cross-platform research
Weekly Installs
55
Repository
merit-systems/a…h-skills
First Seen
Feb 20, 2026
Security Audits
Gen Agent Trust HubPass
SocketWarn
SnykFail
Installed on
kimi-cli55
gemini-cli55
amp55
github-copilot55
codex55
opencode55