Flavio's app supportAll guides · Sign in

← All guides

How to use SEO Bot

SEO Bot

Install SEO Bot, add a site, connect optional data sources, run the 16 tools, use the CLI and hand reports to Cursor or Codex.

Bought SEO Bot? Sign in with the email you bought it with to download the latest version or ask me a question.

On this page

Install SEO Bot

SEO Bot needs macOS 14 or later and runs on Apple silicon and Intel Macs. After purchasing, download the app ZIP from your purchase page, unzip it, and move SEO Bot.app to Applications. The download is signed and notarized by Apple.

Choose SEO Bot › Check for Updates… to check now and Install and Relaunch to install.

Open the app and add a site. Start with Sitemap Health or Internal Links. Both work without a connected account.

Connect optional data sources

Open Settings from the data-source card at the bottom of the sidebar.

These services are optional and separate from the SEO Bot purchase. Your Plausible plan or hosting and DataForSEO usage are billed by those providers. Search Console does not add an SEO Bot charge.

Work through To Do

The overview shows the next ready action. Open To Do to see every action for the site, including checks that have never run and follow-ups after a fix.

A check can be ready, waiting for fresh data or complete. Search Console follow-ups wait long enough for Google’s data to catch up. Crawl follow-ups run sooner. Marking a report fixed adds the right follow-up automatically.

Hand a report to an agent

Set the site’s source folder in Site Settings. A report can then map page URLs to source files and prepare a task for Cursor or Codex.

The handoff contains the report path, exact edits, text to find and the command that marks the work fixed after it is verified, committed and pushed. The prompt waits for you to send it.

Install and use the CLI

Choose SEO Bot → Install Command Line Tool to link seobot into ~/.local/bin. Choose Install Agent Skill to teach supported coding agents the commands.

seobot add seobot-demo.test --source ~/Sites/seobot-demo
seobot run sitemap-health --site seobot-demo.test
seobot reports --site seobot-demo.test
seobot todo --site seobot-demo.test
seobot done --site seobot-demo.test

Run seobot help for every command and option. seobot capabilities prints the agent-ready command manifest.

Back up your data

SEO Bot stores sites, reports, tasks, rank history and credentials in ~/Library/Application Support/SEO Bot. Quit the app and stop any running seobot command before copying that folder.

credentials.json contains unencrypted API keys and tokens so the app and CLI can share them. Keep backups private. SEO Bot has no cloud sync and does not call an AI model.

Build from source

The purchase includes the full MIT-licensed Swift source. Xcode 26 with Swift 6.2 is required.

swift test
./Scripts/build-app.sh
open "dist/SEO Bot.app"

The build script creates a universal app. Without the maintainer’s Developer ID certificate it uses an ad-hoc signature, so macOS can ask for confirmation when you open your own build.

More examples

SEO Bot is $20, a one-time purchase.