@clickminded/coauthor-cli 0.0.42 → 0.0.44
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
|
@@ -28,6 +28,7 @@ SEO mode is rolling out gradually; accounts outside it get `feature_unavailable`
|
|
|
28
28
|
- `coauthor search-brief show <id> --json` shows `data.search_brief`: `status` (`search_play`, `not_search_play`, `not_applicable`, `user_declined`, `not_checked`, or `skipped_busy` / `skipped_credits_exhausted`), the `target` (keyword, monthly volume, difficulty, market, alternatives, secondaries, pages on the user's site that already rank, the information-gain angle), the `analysis` of the ranking pages, and `credits_used`.
|
|
29
29
|
- `coauthor search-brief set-keyword <id> "<phrase>" --json` switches to another keyword (an alternative from `show`, or the user's own). If an outline exists it answers `confirmation_required`: say that the outline, research and draft will be regenerated, and only with the user's OK repeat with `--confirm-reset`.
|
|
30
30
|
- `target.already_ranking_urls` means the user's site already ranks for the keyword with that page; suggest one of the `alternatives` instead of competing with their own page.
|
|
31
|
+
- With a target, the outline is built around it: it covers the topics most ranking pages cover (table stakes), gives the information-gain angle its own section, and uses secondary keywords in headings. `coauthor outline revise` then also returns `data.seo_findings` (for example "missing table stakes: ..."); tell the user when an edit dropped something the post needs to rank.
|
|
31
32
|
|
|
32
33
|
## Writing a sharp brief
|
|
33
34
|
|
|
@@ -24,6 +24,8 @@ coauthor post-details set <id> --seo-title "..." --description "..." --slug "...
|
|
|
24
24
|
|
|
25
25
|
`set` changes only the fields you pass; an empty value clears one. Fields the user or you edited are kept when the draft is regenerated. Keep the SEO title near 60 characters and the description near 155. `post_details_unavailable` means the draft predates post details.
|
|
26
26
|
|
|
27
|
+
For SEO posts on a profile with a website, `post_details.incoming_link_suggestions` lists existing pages on the user's site that could link to the new post: `{status, suggestions: [{url, title, anchor, sentence}]}`. `status` is `ready`, `none`, or `index_not_ready` (the site was still being indexed when the draft was written; links appear on the next post). It is read-only. After the post is published, offer the user the sentences to add on those pages, linking the anchor text to the new post's URL. It is `null` for other posts.
|
|
28
|
+
|
|
27
29
|
## Share link (public)
|
|
28
30
|
|
|
29
31
|
`coauthor share <id> --json` returns `data.share_url`, a public read-only page anyone with the link can open. Create one only when the user asks for a link. Calling it again returns the same link.
|
|
@@ -107,6 +107,7 @@ SEO mode is rolling out gradually; accounts outside it get `feature_unavailable`
|
|
|
107
107
|
- `coauthor search-brief show <id> --json` shows `data.search_brief`: `status` (`search_play`, `not_search_play`, `not_applicable`, `user_declined`, `not_checked`, or `skipped_busy` / `skipped_credits_exhausted`), the `target` (keyword, monthly volume, difficulty, market, alternatives, secondaries, pages on the user's site that already rank, the information-gain angle), the `analysis` of the ranking pages, and `credits_used`.
|
|
108
108
|
- `coauthor search-brief set-keyword <id> "<phrase>" --json` switches to another keyword (an alternative from `show`, or the user's own). If an outline exists it answers `confirmation_required`: say that the outline, research and draft will be regenerated, and only with the user's OK repeat with `--confirm-reset`.
|
|
109
109
|
- `target.already_ranking_urls` means the user's site already ranks for the keyword with that page; suggest one of the `alternatives` instead of competing with their own page.
|
|
110
|
+
- With a target, the outline is built around it: it covers the topics most ranking pages cover (table stakes), gives the information-gain angle its own section, and uses secondary keywords in headings. `coauthor outline revise` then also returns `data.seo_findings` (for example "missing table stakes: ..."); tell the user when an edit dropped something the post needs to rank.
|
|
110
111
|
|
|
111
112
|
### Writing a sharp brief
|
|
112
113
|
|
|
@@ -402,6 +403,8 @@ coauthor post-details set <id> --seo-title "..." --description "..." --slug "...
|
|
|
402
403
|
|
|
403
404
|
`set` changes only the fields you pass; an empty value clears one. Fields the user or you edited are kept when the draft is regenerated. Keep the SEO title near 60 characters and the description near 155. `post_details_unavailable` means the draft predates post details.
|
|
404
405
|
|
|
406
|
+
For SEO posts on a profile with a website, `post_details.incoming_link_suggestions` lists existing pages on the user's site that could link to the new post: `{status, suggestions: [{url, title, anchor, sentence}]}`. `status` is `ready`, `none`, or `index_not_ready` (the site was still being indexed when the draft was written; links appear on the next post). It is read-only. After the post is published, offer the user the sentences to add on those pages, linking the anchor text to the new post's URL. It is `null` for other posts.
|
|
407
|
+
|
|
405
408
|
### Share link (public)
|
|
406
409
|
|
|
407
410
|
`coauthor share <id> --json` returns `data.share_url`, a public read-only page anyone with the link can open. Create one only when the user asks for a link. Calling it again returns the same link.
|