saas-growth-agents README

项目的 README,来自 github.com/Pluviobyte/saas-growth-agents。合并为一个 markdown 文件:README.md。

saas-growth-agents

saas-growth-agents

Hand your SaaS growth chores to an agent that runs them every day.

Spot new search terms, find who ranks for them, check competitor backlinks, submit to directories, and file good posts into a knowledge base.
These jobs repeat daily and follow fixed steps, which makes them perfect SOPs for an agent.
Create a bot, send it one sentence, and it reads this repo, asks you a few questions, and sets itself up.

Stars License Python Data
Grok Bot Muse Dot Hermes OpenClaw Claude Code Codex

Quick start  ·  The bots  ·  One-line setup  ·  AGENTS.md  ·  Grok Bot free for 14 days  ·  English · 简体中文


Data flow: sources go through AIsa into three script pipelines (new-term radar, site ops, social analysis). Scripts only do deterministic work such as collecting, deduping and logging. The agent analyzes, verifies and reports, then pushes to you to decide. State lives in files and ledgers that are read before every run. Spending, sending and deleting all need your OK.

These are the SOPs and scripts the author runs for their own SaaS tools aimed at overseas markets. Any agent that can run terminal commands and keep long-lived instructions can use them.

Coming from douyin-comments? This repo is the old douyin-comments, now merged into the full growth system. The Douyin comments skill is unchanged and lives in the social analysis pack at bots/social-kb/douyin-comments/. See how to reinstall.

The whole system runs on three rules:

  1. Scripts do the deterministic work: collecting, deduping, scoring and logging. Results are reproducible and replayable, never a model's "feeling".
  2. The agent judges: it reads what the scripts produce, then analyzes, extracts, verifies and reports. If data is missing it says so instead of making things up.
  3. You decide: the agent only pushes conclusions. Spending money, sending anything out and deleting all need your OK. Every correction you make becomes a new rule in its skills.

The bots

Bot What you do What it does
New-term radar Nothing Three reports a day on newly searchable terms: new AI products, models, memes, templates. Sources include Google Trends, competitor sitemaps, new directory listings, Product Hunt, GitHub Trending, Reddit and TikTok
Site ops Give it keywords and your product Finds every site competing for a keyword, checks their DR and backlinks, tracks your own site's metrics daily, submits to free directories by the rules, and logs everything
Social analysis pack Drop a link when you see something good Fetches the original (X, Douyin, RedNote, YouTube, WeChat, any web page) → summarizes → extracts "what could improve your SOPs" against your own workflow → files it by topic. For Douyin it can also pull the full comment section

Plus an unrelated extra, Trade radar: watches price moves and breaking events and pushes an analysis. It analyzes only and never places orders.

Which agent

Grok Bot, Muse, Dot, Hermes and OpenClaw all work, and so do Claude Code and Codex. AGENTS.md has the generic steps; each product just has its own name for "routines" (scheduled tasks) and "vault" (secret storage).

The author recommends Grok Bot. It comes with a cloud computer, a vault, skills and routines. These SOPs were first built on Grok Bot, and once installed they run around the clock on routines.

No Grok Bot yet? Sign up with the author's invite link to get 14 days free: https://grok.com/refer/bot?code=NASHTX8NMYH3 (This is a referral link and the author is rewarded for sign-ups. Grok's official page has the current terms.)

Quick start

  1. Create a new bot in your agent.

  2. Send it the matching sentence from bootstrap.md, for example:

    Read AGENTS.md in https://github.com/Pluviobyte/saas-growth-agents and set yourself up as the newterm (new-term radar) bot. Ask me one question at a time.
    
  3. It asks you to put your AIsa key in its vault, does one run by hand to show you, and only turns it into a routine once you're happy.

The whole process is do it once → tweak until it's right → save as a skill → schedule as a routine.

The job descriptions and SOP docs inside the repo are written in Chinese. Agents read them fine, and the bot will talk to you in your language.

Where the data comes from

All external data goes through AIsa: one key for thousands of APIs, pay per call, with MCP support. This repo uses:

Each API maps to one function in lib/aisa/sources.py, with paths and parameters checked against AIsa's official OpenAPI spec. Every request carries a price cap and anything over it is rejected. Not sure what a call costs? Add --quote to ask first; quotes are free.

The AIsa links are the author's referral links. The Douyin comments module doesn't use AIsa; it runs in your own logged-in browser for free.

Optional: run logs

For a sturdier setup where you can trace what went wrong, add the run log module. It records:

A nightly health check lists failed, stuck and missed runs, plus cost spikes.

⚠️ It uses more of your bot's quota, so it's off by default and the bot asks during setup. There are three levels:

  • Light: approvals and rule changes only, almost no extra quota.
  • Standard: adds a record for every routine run.
  • Full: adds the nightly check and weekly archiving.

Logs are local files only, so AIsa costs don't change. (The module's doc is in Chinese; agents read it fine.)

Repo layout

saas-growth-agents/
├── AGENTS.md               setup steps for the agent
├── bootstrap.md            the one sentence to send your bot
├── lib/aisa/               AIsa layer: client.py (stdlib), sources.py (data sources), aisa_cli.py (CLI)
├── lib/runlog/             optional: run log, approvals, rule changes, nightly health check (uses more bot quota)
├── bots/
│   ├── newterm/            new-term radar: job.md · routines.md · check.md · pipeline/ · skills/ · install.sh
│   ├── site-ops/           site ops: job.md · routines.md · check.md · scripts/ · skills/
│   └── social-kb/          social analysis pack: README.md · job.md · routines.md · check.md · scripts/ · douyin-comments/
├── extras/trade-radar/     trade radar (extra)
├── skills/agent-setup/     for Claude Code / Codex: asks what you need and writes a tailored setup message for your bot
├── templates/              ledger formats
└── tests/                  dry-run tests that need no key (all sample data is fictional)

Every bot folder has the same shape: job.md is the job description, routines.md the schedule, check.md the acceptance checklist.

Try it without a key

git clone https://github.com/Pluviobyte/saas-growth-agents.git && cd saas-growth-agents
python3 tests/test_dry_run.py                                        # full dry run
AISA_DRY_RUN=1 python3 bots/site-ops/scripts/serp_sites.py "ai video generator"

Boundaries

License

MIT. Third-party services and credits are in NOTICE.md.

saas-growth-agents (Pluviobyte/saas-growth-agents)

正在搜索数据库…

这是什么?这是一个适用于 Claude Code 的 Agent Skill,可以抓取单个 Douyin 视频的完整评论区(包括一级评论以及所有嵌套回复),并将其整理成一份易读的报告。
这是一个独立的抓取应用,还是在 Claude Code 中运行?它不是独立应用。它作为 Claude Code 的技能运行,通过 Claude in Chrome 扩展程序驱动你自己已登录的 Chrome 标签页,重放页面的真实请求,签名由页面自身的 SDK 计算。
如何安装和使用?将技能文件夹放入你项目的 .claude/skills/ 目录,然后在 Claude Code 中提供一个 Douyin 视频链接,并让它抓取评论;它支持完整视频链接、带 modalid= 的主页链接以及 v.douyin.com 短链接。
运行前需要安装哪些东西?你需要安装 Claude Code 并连接 Claude in Chrome 扩展程序(运行 /chrome),一个已登录 Douyin 的 Chrome 浏览器,以及 Python 3(仅需标准库)和 curl。
遇到 Douyin 验证码时会怎样?它实际能抓取多少内容?它不会替你自动通过验证码,技能会暂停,直到你在 Chrome 中手动完成验证。它一次只能处理一个视频(不支持批量抓取,也不支持 Xiaohongshu 或 Bilibili)。对于评论超过约 1000 条的视频,接口在约 500 条后开始返回重复数据,因此实际总数有时会偏少(在一次测试中,页面显示 1067 条,实际抓取到 823 条)。
这是给谁用的?它面向个人对单个视频的研究和内容参考,不适用于机构的批量采集或商业转售。
为什么不需要 TikHub 或 Playwright?因为它只是重放 Douyin 页面本身已经发出的同一个请求,并让页面自身的 SDK 计算风控签名(abogus、msToken、uifid),因此无需付费使用第三方 API,也无需逆向破解签名算法。
最终会生成什么?会生成一份去重并按点赞数排序的 Markdown 报告(评论全文.md)以及原始 JSON 数据,默认保存在当前项目内的 .internal/抖音评论/ 目录中。
它也能下载视频吗?可以,下载 720p 的源视频是抓取过程中的一个可选步骤。
和手动滚动相比有多快?在 README 的测试中,它从一个 7 分钟的视频中用 138 秒(35 次请求)抓取了 195 条评论,从一个 46 分钟的视频中用 252 秒抓取了 135 条评论,结果与手动点击“展开回复”获得的结果一致;手动操作大约需要 6 分钟。
大小
0.4 MB
星标
542
更新
提交Nov 10
时长
19天
提交 · 90 天