← Back to Skills Marketplace
Cocreator Content Research
by
Miracle Ayodele
· GitHub ↗
· v1.0.2
· MIT-0
497
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install cocreator-content-research
Description
Pure intelligence gathering for social media platforms (TikTok & Instagram). Use when an agent needs to discover trending hooks, analyze a competitor's strat...
README (SKILL.md)
Content Research Skill
This skill provides agents with the ability to gather raw intelligence on social media performance (TikTok and Instagram) using the ScrapeCreators API. It does not generate content or interact with posting APIs.
Prerequisites
uvinstalledSCRAPE_CREATORS_API_KEYset in the environment
Capabilities
1. Broad Content Discovery (Keywords & Hashtags)
Use this to find top-performing content. Agent Instructions for Keyword Search:
- DO NOT use the same hardcoded keyword (like "affirmations") every time.
- ALWAYS brainstorm 3-5 diverse keywords based on the user's app (e.g., if it's an affirmation app, try searching "mindset shift", "daily routine", "self healing", "morning motivation").
- Use time frames (
--date-posted) to find recent trends, and test different sorting methods. - Use the
--formatfilter (video,slideshow, orboth) if the user specifically requests only one type of content. - CRITICAL: The script returns an
is_slideshowboolean and avideo_url. Use this to distinguish between video trends and slideshow trends.
uv run {baseDir}/scripts/keyword-search.py --platform tiktok --type keyword --query "morning routine" --date-posted this-month --sort-by most-liked --format slideshow
uv run {baseDir}/scripts/keyword-search.py --platform instagram --type keyword --query "morning routine" --format video
2. Competitor Hook Research
Use this to analyze specific competitor handles. Agent Instructions for Competitor Research:
- ALWAYS ask the user if they have specific competitors or creator profiles they want you to check before you assume.
- If they don't know, brainstorm potential top creators in their niche using the keyword search first, extract their handles, and then run competitor research on them.
uv run {baseDir}/scripts/competitor-research.py --platform tiktok --handles user1 user2 user3
uv run {baseDir}/scripts/competitor-research.py --platform instagram --handles user1 user2
3. Profile Lookup
Use this to get raw metric data (followers, following, bio) for a specific creator.
uv run {baseDir}/scripts/profile-lookup.py --platform tiktok --handle \x3Chandle>
uv run {baseDir}/scripts/profile-lookup.py --platform instagram --handle \x3Chandle>
Usage Guidance
The skill mostly does what it says: three Python scripts call the ScrapeCreators API using SCRAPE_CREATORS_API_KEY. Before installing or running it, verify you trust the ScrapeCreators service and the skill author. Specifically: (1) avoid running the suggested curl | sh installer unless you trust https://astral.sh — prefer installing 'uv' from a vetted package source or invoke the Python scripts directly; (2) limit the SCRAPE_CREATORS_API_KEY scope and rotate it after testing; (3) run the skill in a sandbox or isolated environment first to observe network traffic and behavior; (4) confirm any costs or rate limits for the ScrapeCreators API and ensure handling of any scraped PII complies with your policies. If you want a lower-risk option, run the included Python scripts directly with Python (they already use requests) and do not execute the remote installer.
Capability Analysis
Type: OpenClaw Skill
Name: cocreator-content-research
Version: 1.0.2
The skill bundle is designed for social media intelligence gathering on TikTok and Instagram using the ScrapeCreators API. The Python scripts (competitor-research.py, keyword-search.py, and profile-lookup.py) perform legitimate GET requests to api.scrapecreators.com and process the resulting JSON data as described. No evidence of data exfiltration, credential theft, or malicious prompt injection was found. The installation step in SKILL.md uses a standard, albeit common security anti-pattern (curl | sh), to install the 'uv' package manager from a legitimate source (astral.sh).
Capability Assessment
Purpose & Capability
Name/description, required env var (SCRAPE_CREATORS_API_KEY), and the three Python scripts all point to social-media research via the ScrapeCreators API; network calls target api.scrapecreators.com endpoints as expected.
Instruction Scope
SKILL.md instructs the agent to run the included scripts (keyword search, competitor research, profile lookup) and to brainstorm queries; it does not instruct reading unrelated local files or exfiltrating environment data beyond the declared API key.
Install Mechanism
The SKILL.md includes an install step that runs a remote shell script (curl -LsSf https://astral.sh/uv/install.sh | sh). Piping an external script to sh is a high-risk install pattern. Also, requiring 'uv' to run simple Python scripts appears disproportionate and unnecessary, increasing attack surface.
Credentials
Only one credential is required (SCRAPE_CREATORS_API_KEY) and it is used consistently by the scripts to authenticate to ScrapeCreators. No unrelated secrets or system credentials are requested.
Persistence & Privilege
The skill is not always-enabled and does not request system-wide configuration changes. It only runs network calls and the provided scripts; the only persistence risk is the optional installer which executes a remote script.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cocreator-content-research - After installation, invoke the skill by name or use
/cocreator-content-research - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Improved agent instructions for keyword searches to encourage brainstorming diverse, relevant keywords and using filters for content type and recency.
- Added guidance on interpreting the is_slideshow field and video_url for better trend identification.
- Updated competitor research instructions to prompt users for specific competitors or, if none are provided, to find top creators via keyword search.
- Expanded usage examples to reflect new instructions and filters.
v1.0.1
- Updated the installation instructions for the required "uv" tool to use a cross-platform bash script instead of Homebrew.
- No changes to features or usage.
v1.0.0
- Initial release of the cocreator-content-research skill, focused on pure intelligence gathering for TikTok and Instagram.
- Enables discovery of trending hooks, competitor analysis, and creator profile lookups using ScrapeCreators API.
- Does not generate or post content; strictly gathers and returns social media data for analysis.
- Requires installation of uv and setting the SCRAPE_CREATORS_API_KEY environment variable.
Metadata
Frequently Asked Questions
What is Cocreator Content Research?
Pure intelligence gathering for social media platforms (TikTok & Instagram). Use when an agent needs to discover trending hooks, analyze a competitor's strat... It is an AI Agent Skill for Claude Code / OpenClaw, with 497 downloads so far.
How do I install Cocreator Content Research?
Run "/install cocreator-content-research" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Cocreator Content Research free?
Yes, Cocreator Content Research is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Cocreator Content Research support?
Cocreator Content Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Cocreator Content Research?
It is built and maintained by Miracle Ayodele (@iammiracle); the current version is v1.0.2.
More Skills