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.
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 10, 2026
Version
1.0.22
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.22release · observed Oct 6, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17d53nb8nd03gyyfdy32rgde58e574f:social-media-research- Install using `clawhub skill install s17d53nb8nd03gyyfdy32rgde58e574f:social-media-research` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/crawlora-org/social-media-research before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-social-media-research/snapshot"
Documentation
CLAWHUB
145,477 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: social-media-research
description: 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.
allowed-tools: Bash(scripts/crawlora.sh:*)
---
# Social media research
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 <handle>'s profile / follower count / recent posts on <platform>?"
- "Pull this post's engagement (likes, comments, shares)."
- "Search <platform> for posts about <topic/hashtag>."
- "What's trending on <platform> 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](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).
- 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`, _meta.json
{
"ownerId": "kn70shhkf6qpfwgfrbgtep2wkd8c6b4t",
"slug": "social-media-research",
"version": "1.0.22",
"publishedAt": 1791253759221
}reference/endpoints.md
# social-media-research — endpoint reference
> Generated from `scripts/tools.json` by `scripts/generate.mjs` — do not edit by hand.
Endpoints this skill uses, grouped by platform. Call them via `scripts/crawlora.sh` (see SKILL.md).
All paths are relative to the API base `https://api.crawlora.net/api/v1` and require the header `x-api-key: $CRAWLORA_API_KEY`. Path params like `{id}` are substituted into the URL; `GET` params go in the query string; `POST` params go in a JSON body.
**86 endpoints across 11 platform group(s).**
## Instagram (3)
### `instagram_post`
- **HTTP:** `GET /instagram/post/{id}/{post_id}`
- **What:** Retrieve a specific Instagram post by URL shortcode. Returns media details for an Instagram URL shortcode. Use media.code from the reels response or shortcode from a public post URL; numeric media IDs are rejected.
- **Params:** `id` (string, **required**) — Instagram user ID retained for route compatibility; ownership is not verified; `post_id` (string, **required**) — Instagram URL shortcode (media.code), not a numeric media ID
### `instagram_profile`
- **HTTP:** `GET /instagram/profile/{username}`
- **What:** Retrieve an Instagram user profile by username. Returns public profile details for a specified Instagram username.
- **Params:** `username` (string, **required**) — Instagram username
### `instagram_reels`
- **HTTP:** `GET /instagram/reels/{id}`
- **What:** Retrieve Instagram Reels for a user. Returns up to 12 public Reels via anonymous proxied HTTP for the numeric Instagram user ID. Supports opaque `max_id` pagination. Captions, timestamps and original image dimensions are omitted when the public source does not expose them.
- **Params:** `id` (string, **required**) — Numeric Instagram user ID (not a username); `max_id` (string, optional) — Pagination cursor for fetching the next page of Reels
## TikTok (25)
### `tiktok_category`
- **HTTP:** `GET /tiktok/category`
- **What:** List TikTok explore categories. Returns the category list exposed by the TikTok Explore page.
- **Params:** _none_
### `tiktok_challenge`
- **HTTP:** `GET /tiktok/hashtag/{name}`
- **What:** Retrieve TikTok hashtag details. Returns the metadata payload for a TikTok hashtag page.
- **Params:** `name` (string, **required**) — Hashtag name (e.g., 'christmas')
### `tiktok_challenge_list`
- **HTTP:** `GET /tiktok/hashtags`
- **What:** Retrieve TikTok hashtag posts. Returns the videos listed for a TikTok hashtag id with cursor-based pagination.
- **Params:** `cursor` (integer, optional) — Pagination cursor; `id` (string, **required**) — Hashtag id returned by the hashtag detail endpoint
### `tiktok_comments`
- **HTTP:** `GET /tiktok/comments`
- **What:** Retrieve TikTok video comments. Returns top-level TikTok video comments with cursor-based pagination.
- **Params:** `aweme_id` (string, **required**) — TikTok video id from the video URL; `cursor` (integer, optional) — Pagination cursor
### `tiktok_creative_center_hashtags`
- **HTTP:skill-card.md
## Description: Researches public social profiles, posts, trends, Facebook Marketplace listings, and explicitly requested Reddit buying-intent leads through the Crawlora API. This skill is ready for commercial/non-commercial use. ## Publisher: [crawlora-org](https://clawhub.ai/user/crawlora-org) ### License/Terms of Use: MIT-0 ## Use Case: External users and marketing teams use this skill to research public social activity, compare profiles and engagement, monitor trends, and perform clearly requested public listing or Reddit lead searches. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The API key and requested search terms, handles, URLs, locations, or listing targets are sent to Crawlora. Mitigation: Use a dedicated API key and send only public, nonsensitive research targets; avoid confidential investigations and sensitive personal data. Risk: Public social data or Reddit lead scores could be misused for sensitive targeting or high-impact decisions. Mitigation: Run lead discovery only when explicitly requested, disclose post-level scoring, and do not infer sensitive traits or make high-impact targeting decisions from results. ## Reference(s): - [ClawHub skill release](https://clawhub.ai/crawlora-org/skills/social-media-research) - [Endpoint reference](reference/endpoints.md) - [Crawlora](https://crawlora.net) ## Skill Output: **Output Type(s):** [Text, Markdown, Shell commands, Guidance] **Output Format:** [Markdown with optional shell examples and JSON excerpts] **Output Parameters:** [1D] **Other Properties Related to Output:** [Research is based on public data returned by Crawlora; list results may require pagination and coverage varies by platform.] ## Skill Version(s): 1.0.22 (source: server-resolved release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/crawlora-org/skills/social-media-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/skills/social-media-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T22:21:38.795Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-social-media-research/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-social-media-research/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T22:21:38.795Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/crawlora-org/social-media-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/social-media-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T22:21:38.795Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.22",
"href": "https://clawhub.ai/crawlora-org/social-media-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/social-media-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-06T02:29:19.221Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-social-media-research/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-social-media-research/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.22",
"description": "Sync skill instructions, references, and helper from GitHub 733b6716a4b74b99991a9802ead5fe2cee6d608b",
"href": "https://clawhub.ai/crawlora-org/social-media-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/social-media-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-06T02:29:19.221Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
