How do I install the SEO Watchlist skill?

Run npx skillmds@latest add zubair-trabzada/seo-watchlist in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is SEO Watchlist safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with SEO Watchlist?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is SEO Watchlist free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published SEO Watchlist?

zubair-trabzada (@zubair-trabzada) published this skill. Their other Agent Skills are listed on their SkillMD profile.

SEO Watchlist by zubair-trabzada — Agent Skill

Name: SEO Watchlist
Author: zubair-trabzada

SEO Watchlist

Track multiple domains and keywords across runs using the DataForSEO SERP API. Saves a local watchlist of domains + their target keywords, then re-runs live rank checks on demand and surfaces any position changes (gains, losses, drops) since the last check.

File contents

Phase 0: Credential Preflight (REQUIRED — run BEFORE anything else)

Before running any of the steps below, always invoke the shared preflight check:

~/.claude/skills/seo/scripts/preflight.sh

If exit code is 0: credentials are configured — proceed with the rest of this skill silently.

If exit code is 2: the script prints the DataForSEO setup wizard to stdout. STOP, display that wizard to the user verbatim, and wait for them to paste credentials in this format:

login: their_email@example.com
password: their_api_password_here

When they reply:

Parse login: and password: from their message.

Write them to ~/.claude/skills/seo/.env:

DATAFORSEO_LOGIN=<login>
DATAFORSEO_PASSWORD=<password>

chmod 600 ~/.claude/skills/seo/.env
Run a verification call: ~/.claude/skills/seo/scripts/keyword_research.py volume "test"
If verification succeeds (real JSON returned): tell the user "✅ Credentials verified. Running your command now..." and proceed with the original request.
If status 40104 — Please verify your account: tell the user to verify their account at https://app.dataforseo.com/, then say "continue" to retry.
If any other auth error: ask them to double-check the API password (the long alphanumeric string from https://app.dataforseo.com/api-access — not their account login password).

Never echo credentials back to the user, never include them in tool output, and never commit them.

SEO Watchlist Skill

Powered by: DataForSEO API — SERP google/organic/live/advanced for live rank checks across the saved keyword set. Cost: ~$0.002 per keyword per check.

A simple file-based watchlist at ~/.claude/skills/seo/output/watchlist.json.

Schema

{
  "domains": {
    "example.com": {
      "label": "Main site",
      "keywords": ["seo audit tool", "keyword research", "..."],
      "history": [
        {"date": "2026-04-15", "rankings": [{"keyword": "...", "position": 8}, ...]},
        {"date": "2026-04-22", "rankings": [{"keyword": "...", "position": 6}, ...]}
      ]
    }
  }
}

Subcommands

`add <domain> <keywords...>`

Read the existing watchlist (if any), add or update the domain entry, write back. Run an immediate rank check and store as the first history entry.

`list`

Print the watchlist in a human-readable table:

Domain | label | # keywords | last checked | last avg position

`check <domain>` or `check all`

Re-run SERP rank check on the saved keywords:

~/.claude/skills/seo/scripts/serp_check.py rank --domain <domain> --keywords <kw...>

Append the result to history, then diff against the previous check:

Movement since <last_date>:
🟢 Up:    "seo audit tool"     8 → 5  (+3)
🔴 Down:  "ai content tool"   12 → 18 (-6)
⚪ Same:  "..." 3 → 3

`remove <domain>` and `remove <domain> <keyword>`

Drop a domain or a single keyword from the watchlist.

Output

Always end with a short take: any concerning drops (-5 or worse), any opportunities (rankings just outside top 10), and one suggested action.

---name: seo-watchlistdescription: Track multiple domains and keywords across runs using the DataForSEO SERP API. Saves a local watchlist of domains + their target keywords, then re-runs live rank checks on demand and surfaces any position changes (gains, losses, drops) since the last check.---## Phase 0: Credential Preflight (REQUIRED — run BEFORE anything else)Before running any of the steps below, **always** invoke the shared preflight check:```bash~/.claude/skills/seo/scripts/preflight.sh```**If exit code is 0:** credentials are configured — proceed with the rest of this skill silently.**If exit code is 2:** the script prints the DataForSEO setup wizard to stdout. STOP, display that wizard to the user verbatim, and **wait for them to paste credentials** in this format:```login: their_email@example.compassword: their_api_password_here```When they reply:1. Parse `login:` and `password:` from their message.2. Write them to `~/.claude/skills/seo/.env`: ``` DATAFORSEO_LOGIN=<login> DATAFORSEO_PASSWORD=<password> ```3. `chmod 600 ~/.claude/skills/seo/.env`4. Run a verification call: `~/.claude/skills/seo/scripts/keyword_research.py volume "test"`5. If verification succeeds (real JSON returned): tell the user "✅ Credentials verified. Running your command now..." and proceed with the original request.6. If status `40104 — Please verify your account`: tell the user to verify their account at https://app.dataforseo.com/, then say "continue" to retry.7. If any other auth error: ask them to double-check the API password (the long alphanumeric string from https://app.dataforseo.com/api-access — not their account login password).**Never** echo credentials back to the user, never include them in tool output, and never commit them.---# SEO Watchlist Skill> **Powered by:** [DataForSEO API](https://dataforseo.com) — SERP `google/organic/live/advanced` for live rank checks across the saved keyword set.> **Cost:** ~$0.002 per keyword per check.A simple file-based watchlist at `~/.claude/skills/seo/output/watchlist.json`.## Schema```json{ "domains": { "example.com": { "label": "Main site", "keywords": ["seo audit tool", "keyword research", "..."], "history": [ {"date": "2026-04-15", "rankings": [{"keyword": "...", "position": 8}, ...]}, {"date": "2026-04-22", "rankings": [{"keyword": "...", "position": 6}, ...]} ] } }}```## Subcommands### `add <domain> <keywords...>`Read the existing watchlist (if any), add or update the domain entry, write back.Run an immediate rank check and store as the first history entry.### `list`Print the watchlist in a human-readable table:- Domain | label | # keywords | last checked | last avg position### `check <domain>` or `check all`Re-run SERP rank check on the saved keywords:```bash~/.claude/skills/seo/scripts/serp_check.py rank --domain <domain> --keywords <kw...>```Append the result to history, then **diff against the previous check**:```Movement since <last_date>:🟢 Up: "seo audit tool" 8 → 5 (+3)🔴 Down: "ai content tool" 12 → 18 (-6)⚪ Same: "..." 3 → 3```### `remove <domain>` and `remove <domain> <keyword>`Drop a domain or a single keyword from the watchlist.## OutputAlways end with a short take: any concerning drops (-5 or worse), anyopportunities (rankings just outside top 10), and one suggested action.

Frequently asked questions