# SeoWatcher — Reporter Onboarding

Short guide for the person who **runs sites and submits a daily report** (`/report`).
Role — `reader`. This is what the admin sends to every new participant.

> All links are at `https://seowatcher.org`. Sign in everywhere with your `key-g.com` Google account.

## 1. Get an access key

Go to `https://seowatcher.org/signup`, sign in with Google. A `psk_…` key appears —
**save it right away, it is shown only once**. Its status will be `pending` —
ping the admin to approve you (it's quick).

## 2. Connect the tool (after the admin approves)

Open `https://seowatcher.org/account`, sign in with Google — there you'll find your key
(**Regenerate** button if you lost it) and the **MCP NAME** field. Put both into the command:

```sh
curl -fsSL https://seowatcher.org/install.sh | sh -s -- <YOUR_KEY> <your-MCP-NAME>
```

Restart `claude`. Check: type `/report` — the skill should be picked up.

Don't want to pipe into shell — install manually:

```sh
mkdir -p ~/.claude/skills/report
curl -fsSL https://seowatcher.org/skills/report/SKILL.md   -o ~/.claude/skills/report/SKILL.md
curl -fsSL https://seowatcher.org/skills/report/report.mjs -o ~/.claude/skills/report/report.mjs
```

…and connect the MCP: `claude mcp add --transport http -s user <your-MCP-NAME> https://seowatcher.org/mcp -H "X-Serverless-Authorization: Bearer <YOUR_KEY>"`.

## 3. Submit a report once a day

Run `/report`. The skill will ask:

- which **domain(s)** the report is for,
- which **period** (Enter = today),
- a short **summary** of the work,
- and, once, your **GitHub / Telegram**.

The **current session in the current directory** is sent (with automatic secret redaction:
your `psk_` token is stripped always and first). Internal key-g.com resource, read by the admin only.

## 4. What you can do (reader role)

Through the MCP `<your-MCP-NAME>` you have read access to the inventory and SEO metrics: list and
cards of sites, portfolio stats, GSC by domain (overview / top queries / top pages / trends),
domain dossier. This is **read-only** — editing the inventory and the team reports are available to other roles.

## 5. If it doesn't work

- `HTTP 403 no associated email` → you're using the wrong key; take the key from
  `/account` (**Regenerate**) and configure it.
- `/report` not picked up → restart `claude`; check that the files are in
  `~/.claude/skills/report/`.
- `HTTP 503 export disabled` → report intake is temporarily off, ping the admin.