@clickminded/coauthor-cli 0.0.86 → 0.0.87
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
|
@@ -2480,7 +2480,11 @@ function seoPlanItemLine(item) {
|
|
|
2480
2480
|
const id = planString(item, 'id') ?? '';
|
|
2481
2481
|
const postType = planString(item, 'post_type');
|
|
2482
2482
|
const linkMagnet = (item.kind === undefined || item.kind === 'post') && postType !== null && SEO_PLAN_LINK_MAGNET_POST_TYPES.includes(postType) ? '[link magnet] ' : '';
|
|
2483
|
-
const
|
|
2483
|
+
const aiGap = item.ai_gap && typeof item.ai_gap === 'object' && Array.isArray(item.ai_gap.competitors)
|
|
2484
|
+
? item.ai_gap.competitors
|
|
2485
|
+
: null;
|
|
2486
|
+
const aiGapTag = aiGap && aiGap.length > 0 ? '[AI gap] ' : '';
|
|
2487
|
+
const head = ` ${id} ${linkMagnet}${aiGapTag}${title}`;
|
|
2484
2488
|
const search = keyword && keyword !== title ? ` [search: ${keyword}]` : '';
|
|
2485
2489
|
const where = planString(item, 'existing_url');
|
|
2486
2490
|
const position = typeof item.existing_position === 'number' ? ` (position ${item.existing_position})` : '';
|
|
@@ -2492,6 +2496,7 @@ function seoPlanItemLine(item) {
|
|
|
2492
2496
|
`${head}${search}${facts ? ` (${facts})` : ''}${written}${dismissed}${done}`,
|
|
2493
2497
|
where ? ` ${where}${position}` : null,
|
|
2494
2498
|
hint ? ` ${hint}` : null,
|
|
2499
|
+
aiGapTag ? ` Google AI answers cite ${aiGap.filter((domain) => typeof domain === 'string').join(', ')} for this, not you.` : null,
|
|
2495
2500
|
].filter(Boolean).join('\n');
|
|
2496
2501
|
}
|
|
2497
2502
|
/**
|
package/package.json
CHANGED
|
@@ -82,6 +82,16 @@ Other fields to use when you recommend an idea:
|
|
|
82
82
|
|
|
83
83
|
A mention is not a citation: most mentions mean the AI read the page while answering. Report both numbers as they are, and do not promise that writing a post will change them. The human output of `show` prints one summary line. The web app shows a "Where AI search mentions you" section.
|
|
84
84
|
|
|
85
|
+
### AI gap ideas
|
|
86
|
+
|
|
87
|
+
Some plans tag ideas whose searches are ones where Google AI answers cite a competitor and never mention the site. Those items carry `ai_gap` (`null` on every other item):
|
|
88
|
+
|
|
89
|
+
- `competitors`: the competitor domains the answers cite, most mentioned first (up to 3).
|
|
90
|
+
- `ai_search_volume`: DataForSEO's estimate of monthly AI searches behind the idea's matching searches.
|
|
91
|
+
- `questions`: on United States / English plans, up to 3 ChatGPT questions about the idea whose answers cite a competitor (`question`, `competitor`). Empty elsewhere.
|
|
92
|
+
|
|
93
|
+
An AI gap idea went through the same checks as every other idea; the tag explains why it matters, it does not mean the idea is more likely to rank. The human output of `show` prefixes it with `[AI gap]` and names the competitors. When you write one, `seo-plan write` puts its questions into the post's brief, and the outline answers them.
|
|
94
|
+
|
|
85
95
|
## Write this
|
|
86
96
|
|
|
87
97
|
`coauthor seo-plan write <item-id> --json` opens a project for a `post` item and returns `data.project_id`, `data.created` and `data.start_prompt`. The project is already set up from the plan: the keyword, the post format, where the product goes, the related searches, and the posts it should link to. You do not need a brief interview or a keyword step.
|
|
@@ -687,6 +687,16 @@ Other fields to use when you recommend an idea:
|
|
|
687
687
|
|
|
688
688
|
A mention is not a citation: most mentions mean the AI read the page while answering. Report both numbers as they are, and do not promise that writing a post will change them. The human output of `show` prints one summary line. The web app shows a "Where AI search mentions you" section.
|
|
689
689
|
|
|
690
|
+
#### AI gap ideas
|
|
691
|
+
|
|
692
|
+
Some plans tag ideas whose searches are ones where Google AI answers cite a competitor and never mention the site. Those items carry `ai_gap` (`null` on every other item):
|
|
693
|
+
|
|
694
|
+
- `competitors`: the competitor domains the answers cite, most mentioned first (up to 3).
|
|
695
|
+
- `ai_search_volume`: DataForSEO's estimate of monthly AI searches behind the idea's matching searches.
|
|
696
|
+
- `questions`: on United States / English plans, up to 3 ChatGPT questions about the idea whose answers cite a competitor (`question`, `competitor`). Empty elsewhere.
|
|
697
|
+
|
|
698
|
+
An AI gap idea went through the same checks as every other idea; the tag explains why it matters, it does not mean the idea is more likely to rank. The human output of `show` prefixes it with `[AI gap]` and names the competitors. When you write one, `seo-plan write` puts its questions into the post's brief, and the outline answers them.
|
|
699
|
+
|
|
690
700
|
### Write this
|
|
691
701
|
|
|
692
702
|
`coauthor seo-plan write <item-id> --json` opens a project for a `post` item and returns `data.project_id`, `data.created` and `data.start_prompt`. The project is already set up from the plan: the keyword, the post format, where the product goes, the related searches, and the posts it should link to. You do not need a brief interview or a keyword step.
|