social-media-research

Researches public profiles, posts, trends, and Facebook Marketplace listings across Instagram, TikTok, Threads, Bluesky, X, Pinterest, LinkedIn, Facebook, Reddit, Bilibili, and Patreon through the Crawlora API. It also supports explicitly requested Reddit buying-intent lead discovery. Use for public social listening, or a clearly requested listings/lead search; avoid sensitive targeting.

Look up public profiles, posts, and engagement, run keyword/hashtag search, and track trending topics across eleven social platforms — all as normalized JSON from the Crawlora API, no app scraping or unofficial client libraries.

Tool scope and data flow

The optional shell helper is the only command this skill asks to run. It makes GET requests only to the documented, allowlisted Crawlora routes. When invoked, it reads CRAWLORA_API_KEY and sends it as an x-api-key header over HTTPS to api.crawlora.net; it does not send the key to social platforms. It briefly writes a mode-600 curl config under TMPDIR and removes it when the command exits. It does not inspect other environment variables, enumerate files, install software, or run with elevated privileges. Search terms, public handles, URLs, and other requested targets are sent to Crawlora; do not submit confidential investigations or sensitive personal data.

The Facebook Marketplace route returns public listings, not social posts. The Reddit leads route ranks public posts for product/service buying intent; use it only for an explicit lead-discovery request, disclose the post-level scoring, and do not infer sensitive traits or target people for high-impact decisions.

When to use this skill

• "What's 's profile / follower count / recent posts on ?"
• "Pull this post's engagement (likes, comments, shares)."
• "Search for posts about <topic/hashtag>."
• "What's trending on right now?"
• Competitor social-listening, influencer research, or brand-mention monitoring.

Setup (one-time)

• Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
• Set CRAWLORA_API_KEY in the environment before running the helper.
• The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

Pick the platform, then the job:

1. Profile — /instagram/profile/{username}, /tiktok/profile/{handler}, /threads/profile/{username}, /bluesky/profile, /x/profile/{username}, /pinterest/user/{username}, /linkedin/company/{id}, /facebook/{page}, /reddit/user/{username}/posts.
2. Posts / feed — /instagram/reels/{id}, /tiktok/posts, /threads/profile/{username}/posts, /bluesky/author-feed, /x/profile/{username}/posts, /pinterest/user/{username}/pins, /reddit/subreddit/{subreddit}/posts.
3. One post/pin/pin detail — /instagram/post/{id}/{post_id}, /tiktok/post/{id}, /threads/post/{username}/{code} (+ /replies), /bluesky/post-thread, /x/post/{id}, /pinterest/pin/{id}, /reddit/post/{id} (+ /reddit/comments/{id}).
4. Search & discovery — /tiktok/search, /tiktok/search_hashtag, /bluesky/search-actors, /pinterest/search, /reddit/search, /facebook/marketplace/search (listings, not social posts), plus Bilibili and Patreon's public discovery endpoints listed in the reference.
5. Trending — /tiktok/trending, /tiktok/creative-center/hashtags, /bluesky/trending-topics, /reddit/trends, /reddit/subreddits/posts (multi-subreddit hot feed).

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

sh

# Profile + posts:
scripts/crawlora.sh /tiktok/profile/nasa | jq '.'
scripts/crawlora.sh /reddit/user/spez/posts | jq '.'

# Search:
scripts/crawlora.sh /tiktok/search keyword="ai agents" | jq '.'
scripts/crawlora.sh /reddit/search q="web scraping" | jq '.'

# Trending:
scripts/crawlora.sh /tiktok/trending | jq '.'
scripts/crawlora.sh /bluesky/trending-topics | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for every Instagram, TikTok, Threads, Bluesky, X, Pinterest, LinkedIn, Facebook, Reddit, Bilibili, and Patreon endpoint this skill uses.

Examples

• Competitor social audit: pull profile + recent posts on each platform a competitor is active on, compare follower counts and post cadence.
• Brand-mention sweep: /reddit/search, /tiktok/search, and /pinterest/search for the same brand/product name, aggregate volume and sentiment cues from captions/comments.
• Influencer vetting: profile + recent posts to check follower count, engagement rate (likes/comments per post), and posting consistency before a partnership.
• Trending-topic scan: /tiktok/trending + /bluesky/trending-topics + /reddit/trends for a same-day cross-platform snapshot.

Notes & limits

• Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
• Public data only — public profiles/posts; no login, no private content. Respect each platform's terms.
• Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
• Coverage varies by platform: X and Instagram expose a narrower public surface (profile + recent posts) than TikTok or Reddit (full search + trending); check reference/endpoints.md before assuming an endpoint exists.
• List endpoints are cursor- or page-paginated — follow the returned cursor to walk beyond the first page.