@letterstory/cli 0.176.24 → 0.176.25
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/lib/cli.mjs +3 -1
- package/lib/commands/insights.mjs +11 -2
- package/package.json +1 -1
package/lib/cli.mjs
CHANGED
|
@@ -82,7 +82,7 @@ import {
|
|
|
82
82
|
import { fetchParkedSections, withoutParked } from "./parked.mjs";
|
|
83
83
|
|
|
84
84
|
// Matches cli/package.json; publish-cli.yml rewrites both to the published version.
|
|
85
|
-
export const VERSION = "0.176.
|
|
85
|
+
export const VERSION = "0.176.25";
|
|
86
86
|
|
|
87
87
|
/** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
|
|
88
88
|
export const EXIT_PAYMENT_REQUIRED = 3;
|
|
@@ -1668,6 +1668,8 @@ Insights:
|
|
|
1668
1668
|
Measure → Reads: AI engines and people reading your sites, counted one way
|
|
1669
1669
|
insights questions [--period 14d|30d|90d] Measure → Questions: every question we ask, named / share / change / cited
|
|
1670
1670
|
insights pages [--period 14d|30d|90d] [--site own|phantoms|<key>] Measure → Pages: your pages AI answers cited, won questions first
|
|
1671
|
+
insights page <page> [--period 14d|30d|90d] [--question <prompt-id>] [--filter all|won] [--limit n]
|
|
1672
|
+
One cited page: the AI answers that linked it, word for word
|
|
1671
1673
|
insights mentions [--site phantoms|<key>]... Measure → Pages → Naming you: which posts on your phantom sites name you
|
|
1672
1674
|
insights competitors [--period 14d|30d|90d] GEO → Competitors: share of mentions per brand, is it moving, by engine/question
|
|
1673
1675
|
insights question <key> [--period 14d|30d|90d] [--filter all|named_you|rival_not_you|no_one] [--limit n]
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
// network, single-post, and top-posts levels (ported from phantomstory-cli's
|
|
3
3
|
// insights.ts); plus Measure's Overview (`summary`), GEO → Competitors
|
|
4
4
|
// (`competitors`), AI Visibility Bank (`bank`) and phantom Page Access (`access`);
|
|
5
|
-
// Measure → Reads (`reads`), Questions (`questions`), Pages (`pages`) and the posts naming you (`mentions`), and the live feed of what
|
|
5
|
+
// Measure → Reads (`reads`), Questions (`questions`), Pages (`pages`, one page's answers `page`) and the posts naming you (`mentions`), and the live feed of what
|
|
6
6
|
// is reading the phantom sites (`activity`) — the same reads the web app renders.
|
|
7
7
|
|
|
8
8
|
import { CliError } from "../client.mjs";
|
|
@@ -42,6 +42,13 @@ export const ARGS = {
|
|
|
42
42
|
period: { flag: "period", enum: PERIODS },
|
|
43
43
|
sites: { flag: "site", type: "list" },
|
|
44
44
|
},
|
|
45
|
+
get_cited_page_answers: {
|
|
46
|
+
page: { positional: 0, label: "page", required: true },
|
|
47
|
+
period: { flag: "period", enum: PERIODS },
|
|
48
|
+
prompt_id: { flag: "question" },
|
|
49
|
+
filter: { flag: "filter", enum: ["all", "won"] },
|
|
50
|
+
limit: { flag: "limit", type: "num" },
|
|
51
|
+
},
|
|
45
52
|
list_site_mentions: {
|
|
46
53
|
sites: { flag: "site", type: "list" },
|
|
47
54
|
},
|
|
@@ -85,13 +92,15 @@ export async function cmdInsights(ctx) {
|
|
|
85
92
|
return call(rest, "list_measure_questions");
|
|
86
93
|
case "pages":
|
|
87
94
|
return call(rest, "list_cited_pages");
|
|
95
|
+
case "page":
|
|
96
|
+
return call(rest, "get_cited_page_answers");
|
|
88
97
|
case "mentions":
|
|
89
98
|
return call(rest, "list_site_mentions");
|
|
90
99
|
case "activity":
|
|
91
100
|
return call(rest, "get_recent_activity");
|
|
92
101
|
default:
|
|
93
102
|
throw new CliError(
|
|
94
|
-
`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, mentions, competitors, question, detection, activity, site, post, top, bank, access`
|
|
103
|
+
`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, competitors, question, detection, activity, site, post, top, bank, access`
|
|
95
104
|
);
|
|
96
105
|
}
|
|
97
106
|
}
|