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)

Ищем в базе…

Что это такое?Это навык Agent Skill для Claude Code, который собирает полную ветку комментариев одного видео в Douyin (комментарии верхнего уровня и все вложенные ответы) и оформляет их в читаемый отчёт.
Это отдельное приложение-парсер или оно работает внутри Claude Code?Это не отдельное приложение. Навык работает внутри Claude Code и управляет вашей уже авторизованной вкладкой Chrome через расширение Claude in Chrome. Он повторяет настоящие запросы страницы, а подпись вычисляет собственный SDK страницы.
Как это установить и пользоваться?Положите папку навыка в каталог .claude/skills/ вашего проекта. Затем в Claude Code дайте ссылку на видео в Douyin и попросите собрать комментарии. Подходят полные ссылки на видео, ссылки на профиль с modalid= и короткие ссылки v.douyin.com.
Что нужно установить, чтобы всё заработало?Нужны Claude Code с подключённым расширением Claude in Chrome (команда /chrome), браузер Chrome, в котором уже выполнен вход в Douyin, а также Python 3 (только стандартная библиотека) и curl.
Что будет, если Douyin покажет капчу и сколько комментариев это вообще может собрать?Капчу навык за вас не проходит: он просто приостанавливается, пока вы не решите её вручную в Chrome. Работает только с одним видео за раз, пакетный сбор не поддерживается, как и Xiaohongshu с Bilibili. На видео с более чем ~1000 комментариями API после примерно 500-го начинает возвращать дубликаты, поэтому итоговое число иногда занижено: в одном тесте собрано 823 из 1067 показанных.
Для кого это сделано?Инструмент создан для личных исследований и работы с контентом по одному видео, а не для агентств, которые занимаются массовым сбором, и не для коммерческого перераспределения данных.
Почему для этого не нужны TikHub или Playwright?Навык просто повторяет точный запрос, который страница Douyin и так делает сама, а защитную подпись (abogus, msToken, uifid) вычисляет собственный SDK страницы. Поэтому не нужно платить за сторонний API или разбирать алгоритм подписи.
Что в итоге получается?Очищенный от дубликатов отчёт в формате Markdown (评论全文.md), отсортированный по лайкам, а также исходный JSON. По умолчанию они сохраняются в .internal/抖音评论/ внутри текущего проекта.
Может ли оно скачать и само видео?Да, скачивание исходного видео в 720p — необязательный дополнительный шаг сбора.
Насколько это быстрее ручной прокрутки?По тестам из README, на 7-минутном видео навык собрал 195 комментариев за 138 секунд (35 запросов), а на 46-минутном — 135 комментариев за 252 секунды. Результаты совпали с тем, что дало ручное нажатие «развернуть ответы», на которое ушло около 6 минут.
Автор
Pluviobyte
Размер
0.4 MB
Звёзды
542
Обновлён
КоммитNov 10
Возраст
19 д
Коммиты · 90 дней