@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 head = ` ${id} ${title}`;
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clickminded/coauthor-cli",
3
- "version": "0.0.70",
3
+ "version": "0.0.71",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "coauthor": "dist/index.js",
@@ -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.