ig-research
GitHub跨平台社交媒体内容研究工具，支持抓取、转录与分析头部内容。提供视频创意生成管线，基于热门视频提取大纲并产出脚本及元数据报告。
Trigger Scenarios
Install
npx skills add leamsigc/ShortsGenerator --skill ig-research -g -y
SKILL.md
Frontmatter
{
"name": "ig-research",
"states": [
"ig-research-setup — Prerequisites, directory, config",
"ig-research-scrape — Scrape posts via Chrome DevTools",
"ig-research-transcribe — Transcribe audio via Whisper",
"ig-research-report — Generate HTML report",
"ig-research-analyze — Content psychology analysis + video ideas pipeline",
{
"video-idea-research — shared playbook": "top-10 videos by views → outlines → 5 ideas → 3 scripts + YouTube metadata"
}
],
"version": "2.0.0",
"description": "Social media content research tool — scrape, transcribe, analyze top-performing\ncontent across platforms (Instagram, Facebook, LinkedIn, X, YouTube).\nMain orchestrator skill. Delegates to state sub-skills for each phase.\nAlso runs the shared video-ideas pipeline (video-idea-research subskill):\nresearch the topic on the platform for the reels\/videos with the most views\nin a window (week\/month\/year) → extract outlines → 5 video ideas × 3\nscripts (viral \/ storytelling \/ inspiration) + YouTube metadata\n(title, description, tags, keywords) → REPORT.html with the top 10 videos\nand the 5 scripted ideas.\n",
"allowed-tools": [
"Bash",
"Read",
"Write",
"Edit",
"Glob",
"Grep",
"Question",
"Skill"
]
}
Social Research Tool — Main Skill
Full workflow: Setup → Scrape → Transcribe → Report → Analyze → Video Ideas
Video Ideas Mode
Given a topic (e.g. "futbol mexicano"), research the platform's top reels by views in a window and build video ideas from them:
/ig-research ideas:<topic> [platform:instagram|facebook|linkedin|x|youtube] [window:week|month|year] [limit:10] [ideas:5] [lang:es]
Full protocol: skill video-idea-research. Instagram specifics:
| Step | How (Instagram) |
|---|---|
| Collect candidates | hashtag pages (/explore/tags/<hashtag>/), reels tab, competitor accounts |
| Window | newest-first browse + post date on each reel page |
| Views | reel page play count when visible; else likes + saves × est. (record the proxy used) |
| Outline | caption = hook; Whisper transcript via scripts/transcribe.sh for beats/CTA |
| Media | reel URLs from the scrape feed the final video (short-generator) |
| Output | video-ideas.json → node "$CLAUDE_SKILL_ROOT/scripts/build-ideas-report.js" <path> (script ships with the video-idea-research skill; fallback: node ./skills/video-idea-research/scripts/build-ideas-report.js <path>) |
Architecture
skills/ig-research/ # Skill (bundled, global-installable via ~/.claude/skills/)
├── SKILL.md
└── scripts/ # Bundled — no external .ig-research/scripts needed
├── package.json
├── scrape.js
├── transcribe.sh
└── report-html.js
.ig-research/ # Tool data directory (project root, auto-resolved)
└── projects/<name>/
├── config.json # Global per-project config
├── latest.json # -> <YYYY-MM-DD_HHMMSS>
└── <YYYY-MM-DD_HHMMSS>/ # One folder per run (dated)
├── raw-posts.json
├── transcripts/
├── hook-screenshots/
└── report.html
Platform Extensibility
Each platform has its own scraper. The config schema includes a platform field:
| Platform | Scraper location | Config platform |
|---|---|---|
scripts/scrape.js (default) |
instagram |
|
platforms/facebook/scrape.js |
facebook |
|
platforms/linkedin/scrape.js |
linkedin |
|
| X | platforms/x/scrape.js |
x |
| YouTube | platforms/youtube/scrape.js |
youtube |
To add a new platform: create a scraper script in skills/ig-research/platforms/<name>/scrape.js (or external platforms/raw-posts.json with the same schema (posts array with postId, type, likes, caption, author, platform, hasScreenshots, hasAudio). The transcribe and report steps work with any platform's output.
Workflow
Load the full workflow with: skill ig-research
Each state can be run independently with: skill ig-research-<state>
# Run full pipeline for a project
skill ig-research-setup # Step 1: Setup (prerequisites + config)
skill ig-research-scrape # Step 2: Scrape Instagram
skill ig-research-transcribe # Step 3: Transcribe audio
skill ig-research-report # Step 4: Generate HTML report
skill ig-research-analyze # Step 5: Content psychology analysis + video ideas
Version History
-
7e4e16b
Current 2026-10-20 01:52
优化错误处理机制，增强对不同研究主题的适应性。
- 7b83166 2026-08-29 02:31
