@clickminded/coauthor-cli 0.0.70 → 0.0.71
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/dist/commands.js
CHANGED
|
@@ -2302,6 +2302,8 @@ function httpErrorCode(error) {
|
|
|
2302
2302
|
const code = planRecord(body.error).code;
|
|
2303
2303
|
return typeof code === 'string' ? code : null;
|
|
2304
2304
|
}
|
|
2305
|
+
/** Post types the plan gives to link magnets: reference posts other sites link to as a source. */
|
|
2306
|
+
const SEO_PLAN_LINK_MAGNET_POST_TYPES = ['stats_hub', 'regulation_tracker', 'cost_reference'];
|
|
2305
2307
|
function seoPlanItemLine(item) {
|
|
2306
2308
|
const keyword = planString(item, 'primary_keyword');
|
|
2307
2309
|
const title = planString(item, 'title') ?? keyword ?? '(untitled)';
|
|
@@ -2311,7 +2313,9 @@ function seoPlanItemLine(item) {
|
|
|
2311
2313
|
planString(item, 'chance'),
|
|
2312
2314
|
].filter(Boolean).join(', ');
|
|
2313
2315
|
const id = planString(item, 'id') ?? '';
|
|
2314
|
-
const
|
|
2316
|
+
const postType = planString(item, 'post_type');
|
|
2317
|
+
const linkMagnet = (item.kind === undefined || item.kind === 'post') && postType !== null && SEO_PLAN_LINK_MAGNET_POST_TYPES.includes(postType) ? '[link magnet] ' : '';
|
|
2318
|
+
const head = ` ${id} ${linkMagnet}${title}`;
|
|
2315
2319
|
const search = keyword && keyword !== title ? ` [search: ${keyword}]` : '';
|
|
2316
2320
|
const where = planString(item, 'existing_url');
|
|
2317
2321
|
const position = typeof item.existing_position === 'number' ? ` (position ${item.existing_position})` : '';
|
package/package.json
CHANGED
|
@@ -52,6 +52,18 @@ Each item has a `kind`, which decides what you can do with it:
|
|
|
52
52
|
| `covered` | The site already ranks well for it. | Nothing. |
|
|
53
53
|
| `not_checked` | Ideas the plan did not have budget to check. | Optional; a later update may check them. |
|
|
54
54
|
|
|
55
|
+
### Link magnets
|
|
56
|
+
|
|
57
|
+
Some `post` items are **link magnets**: reference pages other sites cite as a source, so each link that comes in makes the whole site stronger and helps its other posts rank. A plan holds at most three, and only when the search data shows that pages like this earn links for this kind of site (many plans have none). A link magnet is a `post` item whose `post_type` is one of:
|
|
58
|
+
|
|
59
|
+
- `stats_hub`: a statistics page that collects current numbers on a topic, each with its source.
|
|
60
|
+
- `regulation_tracker`: a rules or law tracker by state, country or city, with the date it was last checked.
|
|
61
|
+
- `cost_reference`: a price or cost reference, with where each figure comes from.
|
|
62
|
+
|
|
63
|
+
They all have `stage: "Learning"`. `reason` holds the evidence in one line (for example "Pages like this earn links from 50+ other sites."), `note` says what to build, and `top_results` lists the pages that earn links today. `chance` is not an outranking chance for these: do not describe a link magnet as an easy win. In the human output of `show` they are prefixed `[link magnet]`; the web app shows a "Link magnet" badge and a "Pages others link to" section.
|
|
64
|
+
|
|
65
|
+
Write one like any other post with `seo-plan write`. Tell the user why it is on the list ("other sites would cite it"), and warn that it needs current, sourced figures: a link magnet is only worth building if every number is dated and traceable. Do not pick a link magnet for the user over their easier posts unless they ask for link building.
|
|
66
|
+
|
|
55
67
|
Other fields to use when you recommend an idea:
|
|
56
68
|
|
|
57
69
|
- `stage`: `Ready to buy`, `Comparing options` or `Learning`. It sets how strong the post's call to action is.
|
|
@@ -647,6 +647,18 @@ Each item has a `kind`, which decides what you can do with it:
|
|
|
647
647
|
| `covered` | The site already ranks well for it. | Nothing. |
|
|
648
648
|
| `not_checked` | Ideas the plan did not have budget to check. | Optional; a later update may check them. |
|
|
649
649
|
|
|
650
|
+
#### Link magnets
|
|
651
|
+
|
|
652
|
+
Some `post` items are **link magnets**: reference pages other sites cite as a source, so each link that comes in makes the whole site stronger and helps its other posts rank. A plan holds at most three, and only when the search data shows that pages like this earn links for this kind of site (many plans have none). A link magnet is a `post` item whose `post_type` is one of:
|
|
653
|
+
|
|
654
|
+
- `stats_hub`: a statistics page that collects current numbers on a topic, each with its source.
|
|
655
|
+
- `regulation_tracker`: a rules or law tracker by state, country or city, with the date it was last checked.
|
|
656
|
+
- `cost_reference`: a price or cost reference, with where each figure comes from.
|
|
657
|
+
|
|
658
|
+
They all have `stage: "Learning"`. `reason` holds the evidence in one line (for example "Pages like this earn links from 50+ other sites."), `note` says what to build, and `top_results` lists the pages that earn links today. `chance` is not an outranking chance for these: do not describe a link magnet as an easy win. In the human output of `show` they are prefixed `[link magnet]`; the web app shows a "Link magnet" badge and a "Pages others link to" section.
|
|
659
|
+
|
|
660
|
+
Write one like any other post with `seo-plan write`. Tell the user why it is on the list ("other sites would cite it"), and warn that it needs current, sourced figures: a link magnet is only worth building if every number is dated and traceable. Do not pick a link magnet for the user over their easier posts unless they ask for link building.
|
|
661
|
+
|
|
650
662
|
Other fields to use when you recommend an idea:
|
|
651
663
|
|
|
652
664
|
- `stage`: `Ready to buy`, `Comparing options` or `Learning`. It sets how strong the post's call to action is.
|