Jakeschincariol/instagram-agent-skill

项目介绍

这个仓库把十三个 Claude 技能和五个零依赖 Python 工具打包在一起，用来运营 Instagram 账号。技能覆盖 Reels、文案、轮播、故事、主页评分、周计划、评论、回复、私信、内容改写和发布复盘。设计上是「先写作、最后人工发布」：每个技能都输出可直接复制的内容块，由账号主人自己发出去。

Python 工具是可量化检查的部分。hookscore.py 用五项属性对候选钩子打分，并对照 26 个带评分的钩子公式；beats.py 按给定语速把脚本排成带时间码的节拍表；caption.py 预览信息流里可见的 125 个字符，并检查长度、标签和搜索词；humanize.py 与 detect.py 清理并评分草稿中的套话、不可见字符和结构性痕迹；swipe.py 按每条 Reel 相对该账号中位数的倍数排序已抓取的内容。

它适合本来就自己写帖、想要一套发布前检查流程的创作者，也适合能运行短 Python 脚本并愿意修改 JSON 配置的开发者。

快速使用

安装有三种方式：让 Claude 从仓库安装、克隆后把技能目录复制到 ~/.claude/skills/，或把仓库加入插件市场再安装 instagram-agent。想要项目局部生效时，把同样的目录复制到目标仓库的 .claude/skills/。不用 Claude Code 时，可以把单个 SKILL.md 贴在对话开头使用，但这样会失去五个 Python 工具。

git clone https://github.com/Jakeschincariol/instagram-agent-skill.git
cp -r instagram-agent-skill/skills/ig-* ~/.claude/skills/

使用技能前先填写声音档案：把 templates/voice.md 复制到 ~/.claude/instagram/voice.md，或者给 Claude 三条自己的 Reel，让它代写。所有技能都会读取这个文件。

针对本地文本文件运行工具，例如：

python3 hookscore.py hooks.txt
python3 beats.py script.txt --target 30
python3 caption.py caption.txt --keywords "client contracts,freelance pricing"
python3 humanize.py draft.txt --report
python3 detect.py draft.txt
python3 swipe.py captured.tsv --out ~/.claude/instagram/swipe.md

每个工具都会打印报告：hookscore.py 给出按分数排序的钩子、最弱项和致命问题；caption.py 打印信息流可见窗口和 PASS/WARN 检查项。

使用约束

这些技能不会替你发布、评论、关注或私信。README 说明 Content Publishing API 需要 Meta 开发者应用、关联主页、长期令牌和审核，而用浏览器自动化或第三方工具发布违反 Instagram 使用条款。/ig-viral 是在你本人浏览器上、以人类速度读取约十个账号，不是自动爬虫。

检测面板是本地启发式规则，不调用 GPTZero、Originality、Copyleaks 等服务，也不承诺与它们相同的判定。不可见字符清理针对零宽字符和格式字符，不涉及密码学水印。钩子评分器在 74 条 YouTube Shorts 钩子上测过：对故意写坏的钩子 AUC 0.83，但区分同一位创作者的热门与冷门只有 AUC 0.56，所以它适合淘汰明显弱的钩子，不能预测爆款。草稿需要你未提供的数字时，会留下 {{your number}} 占位。平台规则会变，README 记录标签上限已在 2025 年 12 月改为每帖五个。许可证为 MIT。

HotRepo 点评

站内只有 2026 年 11 月 13 日一条 Python 周榜记录：6,301 Star、1,231 Fork，当周新增 1,223 Star，周榜最好名次第 16。仓库创建于 2026 年 9 月，这条记录只能说明当周事实，不足以判断长期趋势。更值得注意的是仓库自己披露的负面测量：钩子评分器不能区分同一创作者的热门与冷门，公式分类器最初只匹配 8% 的真实钩子，改写后到 49%；而且刻意不提供自动发布。对一个这个量级的仓库来说，这些坦白本身就是主要技术信号。

项目源码与说明