seo 0.4.1 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "seo",
3
- "version": "0.4.1",
4
- "mcpName": "io.github.iannuttall/seo",
3
+ "version": "0.5.0",
4
+ "mcpName": "dev.seoskill/seo",
5
5
  "description": "The SEO command for AI agents: a free Google Search Console MCP server and CLI. Reads your real Search Console, Google Analytics and Bing data for traffic drops, quick wins, content decay, cannibalization and indexing, plus DataForSEO and Ahrefs keyword research.",
6
6
  "type": "module",
7
7
  "license": "Apache-2.0",
@@ -14,12 +14,15 @@ There are two ways to reach the same commands:
14
14
 
15
15
  - **MCP tools**, from the hosted server at `https://seoskill.dev/mcp` or the
16
16
  local server from `seo mcp serve`. Use them when they are connected.
17
- - **The CLI**. Before the first call, run `command -v seo`. If it is missing,
18
- run `npm i -g seo`, then `seo start` to sign in with Google. Add `--json`
19
- for machine-readable output; JSON mode never prompts.
17
+ - **The CLI**: `seo`, or `npx -y seo` when it is not installed. Sign in
18
+ once with `seo login`: show the person the link it prints, then run
19
+ `seo login` again after they approve. It uses the same seoskill.dev
20
+ account as the hosted server (Google accounts, Bing, keys). A cloud agent
21
+ can use an account-page token as `SEO_TOKEN`. Add `--json` for JSON; it
22
+ never prompts.
20
23
 
21
- Crawls, internal links and Bing run only on the person's machine, through
22
- the CLI or the local MCP server.
24
+ Crawls, internal links and Bing run only in the CLI or the local MCP
25
+ server, on any machine with a shell.
23
26
 
24
27
  ## The commands
25
28
 
@@ -52,9 +55,6 @@ CLI commands need `--site` (or `--url`): `example.com`, a URL or
52
55
  4. Each result ends with the command to run next. Follow it when it fits the
53
56
  question.
54
57
 
55
- Each command takes a target and optional dates. Everything else is automatic
56
- and shown in the output.
57
-
58
58
  ## Common jobs
59
59
 
60
60
  | Job | Commands |
@@ -76,17 +76,18 @@ and shown in the output.
76
76
  The report overview shows Google and Bing clicks for the same dates. The
77
77
  `bing` section puts Bing's top queries and pages beside Google's numbers. Never
78
78
  add Bing to Google. Bing lists only its top rows by week, so a missing row is
79
- unknown, not zero. Bing runs in the CLI and local MCP server: connect it once
80
- with `seo providers bing connect` (or `SEO_BING_API_KEY`). The hosted server
81
- has no Bing yet, so its totals are Google only: no Bing data there is not
82
- "no Bing traffic". Run `npx -y seo report --site <site> --section bing --json`.
79
+ unknown, not zero. Bing runs in the CLI and local MCP server: connect Bing
80
+ on the account page and run `seo login`, or use `seo providers bing connect`.
81
+ The hosted server cannot reach Bing, so its totals are Google only: no Bing
82
+ data there is not "no Bing traffic". Run
83
+ `npx -y seo report --site <site> --section bing --json`.
83
84
 
84
85
  ## Research keys
85
86
 
86
- Research costs the person's own provider credits. On the hosted server, add
87
- keys and missing Google accounts at `https://seoskill.dev/account`, or send
88
- keys as client headers. In the CLI and local server, run
89
- `seo providers <name> connect`. Domain Rating appears
87
+ Research costs the person's own provider credits. Keys and missing Google
88
+ accounts are added at `https://seoskill.dev/account`; the hosted server and
89
+ a CLI linked with `seo login` both use them. `seo providers <name> connect`
90
+ keeps a key on one machine only. Domain Rating appears
90
91
  as a free column next to domains; credit it as "Domain Rating by Ahrefs".
91
92
 
92
93
  ## Evidence rules