seo 0.5.0 → 0.6.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/PRIVACY.md CHANGED
@@ -7,7 +7,7 @@ the hosted MCP server at seoskill.dev/mcp with its account page, and the
7
7
  seoskill.dev website.
8
8
 
9
9
  In short: the hosted MCP keeps only your linked Google and Bing accounts, any
10
- API keys you save and the machines you link, encrypted, so it can fetch your
10
+ API keys and Clicky sites you save and the machines you link, encrypted, so it can fetch your
11
11
  own data when you ask. It never
12
12
  keeps your Search Console or analytics data, your reports or a log of your
13
13
  requests. The only thing kept about your use is an anonymous usage
@@ -38,6 +38,16 @@ Cloudflare D1 with only these things:
38
38
  from its sites.
39
39
  - **Your API keys, if you save them.** A DataForSEO login and password and an
40
40
  Ahrefs key.
41
+ - **Your Clicky sites, if you save them.** Each site's numeric site ID,
42
+ sitekey and domain. The domain comes from Clicky when you save the site,
43
+ so agents can name the site.
44
+ - **Your Clicky account login, if you save it.** Your Clicky username or
45
+ email and your Clicky password. Clicky has no other way to list an
46
+ account's sites, so the server keeps the password, encrypted, and uses it
47
+ only to read your Clicky site list: when you save it, and again when an
48
+ agent asks for a Clicky site that is not saved yet. The password is never
49
+ sent to a linked machine. Remove it on the account page, and change your
50
+ password at Clicky if you want to be sure it no longer works.
41
51
  - **Machines you link with `seo login`.** A name such as "seo on
42
52
  my-laptop", made from the machine's host name, and the date it was last
43
53
  used. A linked machine asks for short-lived Google and Bing tokens and your
@@ -52,7 +62,7 @@ The server keeps nothing else. It does not keep reports, Search Console
52
62
  or Google Analytics rows, lists of your sites, or the pages it checked.
53
63
  Request logs are turned off.
54
64
 
55
- - **Your data.** Search Console, Google Analytics and provider responses are
65
+ - **Your data.** Search Console, Google Analytics, Clicky and provider responses are
56
66
  fetched for each request, returned to your MCP client and not kept. Pages checked live are fetched for the request and not kept.
57
67
  - **API key headers.** You can send `X-DataForSEO-Login`,
58
68
  `X-DataForSEO-Password` and `X-Ahrefs-Key` headers instead of saving keys.
@@ -63,7 +73,10 @@ Request logs are turned off.
63
73
  agent. It sets one essential cookie that holds your
64
74
  encrypted person id for up to 30 days.
65
75
  - **Outside services.** Google answers its own requests. The provider you
66
- choose receives your research request under its own policy.
76
+ choose receives your research request under its own policy. Clicky
77
+ receives the site ID, sitekey, report types and dates for a Clicky request,
78
+ and your Clicky username and password when the server reads your Clicky
79
+ site list.
67
80
  Ahrefs receives the domains in research rows for the free Domain Rating
68
81
  column. Cloudflare runs the server, stores the encrypted data and handles
69
82
  the network requests.
@@ -74,8 +87,8 @@ Request logs are turned off.
74
87
  ### Delete your hosted data
75
88
 
76
89
  Sign in at [seoskill.dev/account](https://seoskill.dev/account) and choose
77
- **Delete everything**. It deletes your person id, linked accounts, keys and
78
- linked machines,
90
+ **Delete everything**. It deletes your person id, linked accounts, keys,
91
+ Clicky sites and linked machines,
79
92
  and revokes the Google sign-ins. Your agents will ask you to sign in again if
80
93
  you use the hosted server later. You can also revoke SEO Skill in your
81
94
  [Google Account connections](https://myaccount.google.com/connections), which
@@ -111,7 +124,9 @@ including its Limited Use requirements.
111
124
 
112
125
  ## Clicky data the software can access
113
126
 
114
- Clicky access is optional. If you connect a site, the software sends its numeric
127
+ Clicky access is optional. The hosted server and a CLI linked with
128
+ `seo login` use the Clicky sites saved on your account, as described above.
129
+ If you connect a site on your machine, the software sends its numeric
115
130
  site ID, sitekey, requested report type, date range, and row limit directly to
116
131
  Clicky over HTTPS. It can read the traffic data that sitekey permits. The
117
132
  project maintainer does not receive the request or response.
package/README.md CHANGED
@@ -209,18 +209,18 @@ seo analytics google properties
209
209
  seo ai-referrals --property 123456789
210
210
  ```
211
211
 
212
- Clicky is available through the
213
- [Clicky provider package](https://github.com/iannuttall/seoskill-clicky-provider).
214
- Install it, then connect a site with its Clicky site ID:
212
+ For Clicky, save your Clicky account login (every site) or one site's ID and
213
+ sitekey on your [account page](https://seoskill.dev/account#clicky). The
214
+ hosted server and a CLI linked with `seo login` both read them:
215
215
 
216
216
  ```sh
217
- seo providers install @seoskill/clicky-provider
218
- seo analytics clicky connect --site-id 12345
217
+ seo data --source clicky --site example.com
219
218
  ```
220
219
 
221
- The hosted server reads Google Analytics only. Clicky runs on your machine,
222
- and the hosted server tells your agent to use the CLI for it, as it does for
223
- crawls. For any other analytics tool, build a provider package with the
220
+ A site saved on your machine with the
221
+ [Clicky provider package](https://github.com/iannuttall/seoskill-clicky-provider)
222
+ (`seo analytics clicky connect --site-id 12345`) works too, by its site ID.
223
+ For any other analytics tool, build a provider package with the
224
224
  public provider SDK; the Clicky package is the example. Each source keeps its
225
225
  own metric names, so a Clicky visit is never relabelled as a Google Analytics
226
226
  user.