@automatelab/citation-intelligence 0.5.1 → 0.7.0
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/README.md +74 -8
- package/dist/adapters/anthropic.d.ts.map +1 -1
- package/dist/adapters/anthropic.js +4 -2
- package/dist/adapters/anthropic.js.map +1 -1
- package/dist/adapters/bing.js +1 -1
- package/dist/adapters/bing.js.map +1 -1
- package/dist/adapters/brave.js +1 -1
- package/dist/adapters/brave.js.map +1 -1
- package/dist/adapters/gemini.d.ts.map +1 -1
- package/dist/adapters/gemini.js +5 -1
- package/dist/adapters/gemini.js.map +1 -1
- package/dist/adapters/google-ai-mode.d.ts +6 -0
- package/dist/adapters/google-ai-mode.d.ts.map +1 -0
- package/dist/adapters/google-ai-mode.js +48 -0
- package/dist/adapters/google-ai-mode.js.map +1 -0
- package/dist/adapters/openai.d.ts.map +1 -1
- package/dist/adapters/openai.js +3 -1
- package/dist/adapters/openai.js.map +1 -1
- package/dist/adapters/perplexity.d.ts +2 -1
- package/dist/adapters/perplexity.d.ts.map +1 -1
- package/dist/adapters/perplexity.js +5 -2
- package/dist/adapters/perplexity.js.map +1 -1
- package/dist/index.js +50 -2
- package/dist/index.js.map +1 -1
- package/dist/prompts.d.ts +3 -0
- package/dist/prompts.d.ts.map +1 -0
- package/dist/prompts.js +137 -0
- package/dist/prompts.js.map +1 -0
- package/dist/resources.d.ts +3 -0
- package/dist/resources.d.ts.map +1 -0
- package/dist/resources.js +242 -0
- package/dist/resources.js.map +1 -0
- package/dist/tools/am-i-cited.d.ts +73 -10
- package/dist/tools/am-i-cited.d.ts.map +1 -1
- package/dist/tools/am-i-cited.js +115 -15
- package/dist/tools/am-i-cited.js.map +1 -1
- package/dist/tools/answer-box-position.d.ts +4 -4
- package/dist/tools/answer-box-position.js +2 -2
- package/dist/tools/answer-box-position.js.map +1 -1
- package/dist/tools/canonical-competitor-set.d.ts +73 -0
- package/dist/tools/canonical-competitor-set.d.ts.map +1 -0
- package/dist/tools/canonical-competitor-set.js +208 -0
- package/dist/tools/canonical-competitor-set.js.map +1 -0
- package/dist/tools/check-citations.d.ts +11 -5
- package/dist/tools/check-citations.d.ts.map +1 -1
- package/dist/tools/check-citations.js +41 -8
- package/dist/tools/check-citations.js.map +1 -1
- package/dist/tools/citation-evidence.d.ts +54 -0
- package/dist/tools/citation-evidence.d.ts.map +1 -0
- package/dist/tools/citation-evidence.js +148 -0
- package/dist/tools/citation-evidence.js.map +1 -0
- package/dist/tools/citation-freshness-score.d.ts +4 -4
- package/dist/tools/citation-freshness-score.js +1 -1
- package/dist/tools/citation-freshness-score.js.map +1 -1
- package/dist/tools/citation-provenance.d.ts +6 -4
- package/dist/tools/citation-provenance.d.ts.map +1 -1
- package/dist/tools/citation-provenance.js +17 -8
- package/dist/tools/citation-provenance.js.map +1 -1
- package/dist/tools/cited-for-diff.d.ts +5 -5
- package/dist/tools/cited-for-diff.js +1 -1
- package/dist/tools/cited-for-diff.js.map +1 -1
- package/dist/tools/cited-for.d.ts +5 -5
- package/dist/tools/cited-for.js +1 -1
- package/dist/tools/cited-for.js.map +1 -1
- package/dist/tools/compete-for-query.d.ts +4 -4
- package/dist/tools/compete-for-query.js +1 -1
- package/dist/tools/compete-for-query.js.map +1 -1
- package/dist/tools/crawler-access-audit.d.ts +49 -0
- package/dist/tools/crawler-access-audit.d.ts.map +1 -0
- package/dist/tools/crawler-access-audit.js +256 -0
- package/dist/tools/crawler-access-audit.js.map +1 -0
- package/dist/tools/gsc-citation-gap.d.ts +5 -5
- package/dist/tools/gsc-citation-gap.d.ts.map +1 -1
- package/dist/tools/gsc-citation-gap.js +7 -2
- package/dist/tools/gsc-citation-gap.js.map +1 -1
- package/dist/tools/run-panel.d.ts +5 -5
- package/dist/tools/run-panel.d.ts.map +1 -1
- package/dist/tools/run-panel.js +13 -4
- package/dist/tools/run-panel.js.map +1 -1
- package/dist/tools/sitemap-citation-map.d.ts +77 -0
- package/dist/tools/sitemap-citation-map.d.ts.map +1 -0
- package/dist/tools/sitemap-citation-map.js +149 -0
- package/dist/tools/sitemap-citation-map.js.map +1 -0
- package/dist/tools/structured-data-repair.d.ts +30 -0
- package/dist/tools/structured-data-repair.d.ts.map +1 -0
- package/dist/tools/structured-data-repair.js +297 -0
- package/dist/tools/structured-data-repair.js.map +1 -0
- package/dist/types.d.ts +11 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +24 -1
- package/dist/types.js.map +1 -1
- package/package.json +59 -57
- package/smithery.yaml +50 -0
|
@@ -2,29 +2,29 @@ import { z } from "zod";
|
|
|
2
2
|
export declare const citedForInputSchema: {
|
|
3
3
|
domain: z.ZodString;
|
|
4
4
|
since: z.ZodOptional<z.ZodString>;
|
|
5
|
-
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
5
|
+
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode"]>>;
|
|
6
6
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
7
7
|
};
|
|
8
8
|
declare const inputSchema: z.ZodObject<{
|
|
9
9
|
domain: z.ZodString;
|
|
10
10
|
since: z.ZodOptional<z.ZodString>;
|
|
11
|
-
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
11
|
+
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode"]>>;
|
|
12
12
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
13
13
|
}, "strip", z.ZodTypeAny, {
|
|
14
14
|
domain: string;
|
|
15
15
|
limit: number;
|
|
16
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
16
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | undefined;
|
|
17
17
|
since?: string | undefined;
|
|
18
18
|
}, {
|
|
19
19
|
domain: string;
|
|
20
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
20
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | undefined;
|
|
21
21
|
since?: string | undefined;
|
|
22
22
|
limit?: number | undefined;
|
|
23
23
|
}>;
|
|
24
24
|
export declare function citedFor(input: z.infer<typeof inputSchema>): Promise<{
|
|
25
25
|
domain: string;
|
|
26
26
|
since: string | undefined;
|
|
27
|
-
engine_filter: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
27
|
+
engine_filter: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | undefined;
|
|
28
28
|
results: {
|
|
29
29
|
query: string;
|
|
30
30
|
engine: import("../types.js").Engine;
|
package/dist/tools/cited-for.js
CHANGED
|
@@ -7,7 +7,7 @@ export const citedForInputSchema = {
|
|
|
7
7
|
.optional()
|
|
8
8
|
.describe("ISO date floor, e.g. '2026-01-01'. Only return entries fetched on or after this date."),
|
|
9
9
|
engine: z
|
|
10
|
-
.enum(["perplexity", "claude", "openai", "gemini", "
|
|
10
|
+
.enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode"])
|
|
11
11
|
.optional()
|
|
12
12
|
.describe("Filter by engine. Omit to include all."),
|
|
13
13
|
limit: z.number().int().min(1).max(500).default(50).describe("Maximum results."),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cited-for.js","sourceRoot":"","sources":["../../src/tools/cited-for.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACjF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uFAAuF,CAAC;IACpG,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"cited-for.js","sourceRoot":"","sources":["../../src/tools/cited-for.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACjF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uFAAuF,CAAC;IACpG,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC;SAC/F,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CACjF,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAkC;IAC/D,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,cAAc,CAClC,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,CACb,CAAC;IACF,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,aAAa,EAAE,MAAM,CAAC,MAAM;QAC5B,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,MAAM,EAAE,aAAsB;KAC/B,CAAC;AACJ,CAAC"}
|
|
@@ -2,23 +2,23 @@ import { z } from "zod";
|
|
|
2
2
|
export declare const competeForQueryInputSchema: {
|
|
3
3
|
query: z.ZodString;
|
|
4
4
|
your_url: z.ZodString;
|
|
5
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
5
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
6
6
|
max_competitors: z.ZodDefault<z.ZodNumber>;
|
|
7
7
|
};
|
|
8
8
|
declare const inputSchema: z.ZodObject<{
|
|
9
9
|
query: z.ZodString;
|
|
10
10
|
your_url: z.ZodString;
|
|
11
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
11
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
12
12
|
max_competitors: z.ZodDefault<z.ZodNumber>;
|
|
13
13
|
}, "strip", z.ZodTypeAny, {
|
|
14
14
|
query: string;
|
|
15
|
-
engine: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
15
|
+
engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto";
|
|
16
16
|
your_url: string;
|
|
17
17
|
max_competitors: number;
|
|
18
18
|
}, {
|
|
19
19
|
query: string;
|
|
20
20
|
your_url: string;
|
|
21
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
21
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto" | undefined;
|
|
22
22
|
max_competitors?: number | undefined;
|
|
23
23
|
}>;
|
|
24
24
|
export declare function competeForQuery(input: z.infer<typeof inputSchema>): Promise<{
|
|
@@ -9,7 +9,7 @@ export const competeForQueryInputSchema = {
|
|
|
9
9
|
.url()
|
|
10
10
|
.describe("Your URL to benchmark against the cited competitors."),
|
|
11
11
|
engine: z
|
|
12
|
-
.enum(["perplexity", "claude", "openai", "gemini", "
|
|
12
|
+
.enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"])
|
|
13
13
|
.default("auto")
|
|
14
14
|
.describe("AI engine to query for the citation set. 'auto' picks the first available key."),
|
|
15
15
|
max_competitors: z
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compete-for-query.js","sourceRoot":"","sources":["../../src/tools/compete-for-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACzF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,CAAC,sDAAsD,CAAC;IACnE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"compete-for-query.js","sourceRoot":"","sources":["../../src/tools/compete-for-query.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const crawlerAccessAuditInputSchema: {
|
|
3
|
+
url: z.ZodString;
|
|
4
|
+
bots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
5
|
+
fetch_with_ua: z.ZodDefault<z.ZodBoolean>;
|
|
6
|
+
};
|
|
7
|
+
declare const inputSchema: z.ZodObject<{
|
|
8
|
+
url: z.ZodString;
|
|
9
|
+
bots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
10
|
+
fetch_with_ua: z.ZodDefault<z.ZodBoolean>;
|
|
11
|
+
}, "strip", z.ZodTypeAny, {
|
|
12
|
+
url: string;
|
|
13
|
+
fetch_with_ua: boolean;
|
|
14
|
+
bots?: string[] | undefined;
|
|
15
|
+
}, {
|
|
16
|
+
url: string;
|
|
17
|
+
bots?: string[] | undefined;
|
|
18
|
+
fetch_with_ua?: boolean | undefined;
|
|
19
|
+
}>;
|
|
20
|
+
type BotResult = {
|
|
21
|
+
name: string;
|
|
22
|
+
ua_token: string;
|
|
23
|
+
operator: string;
|
|
24
|
+
purpose: string;
|
|
25
|
+
robots_allowed: boolean | "unknown";
|
|
26
|
+
robots_rule: string | null;
|
|
27
|
+
fetch_status: number | null;
|
|
28
|
+
fetch_ok: boolean | null;
|
|
29
|
+
fetch_error: string | null;
|
|
30
|
+
verdict: "allowed" | "blocked" | "robots_only_allowed" | "robots_only_blocked" | "unknown";
|
|
31
|
+
};
|
|
32
|
+
export declare function crawlerAccessAudit(input: z.infer<typeof inputSchema>): Promise<{
|
|
33
|
+
url: string;
|
|
34
|
+
robots_url: string;
|
|
35
|
+
robots_status: number | null;
|
|
36
|
+
robots_present: boolean;
|
|
37
|
+
robots_error: string | null;
|
|
38
|
+
fetched_at: string;
|
|
39
|
+
bots: BotResult[];
|
|
40
|
+
summary: {
|
|
41
|
+
total: number;
|
|
42
|
+
allowed: number;
|
|
43
|
+
blocked: number;
|
|
44
|
+
unknown: number;
|
|
45
|
+
};
|
|
46
|
+
note: string;
|
|
47
|
+
}>;
|
|
48
|
+
export {};
|
|
49
|
+
//# sourceMappingURL=crawler-access-audit.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"crawler-access-audit.d.ts","sourceRoot":"","sources":["../../src/tools/crawler-access-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,6BAA6B;;;;CAmBzC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAA0C,CAAC;AA8G5D,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,qBAAqB,GAAG,qBAAqB,GAAG,SAAS,CAAC;CAC5F,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;GAsJ1E"}
|
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import robotsParserDefault from "robots-parser";
|
|
3
|
+
import { fetchText } from "../lib/fetch.js";
|
|
4
|
+
import { log } from "../lib/log.js";
|
|
5
|
+
const robotsParser = robotsParserDefault;
|
|
6
|
+
export const crawlerAccessAuditInputSchema = {
|
|
7
|
+
url: z
|
|
8
|
+
.string()
|
|
9
|
+
.url()
|
|
10
|
+
.describe("Page URL to test for AI crawler access."),
|
|
11
|
+
bots: z
|
|
12
|
+
.array(z.string())
|
|
13
|
+
.min(1)
|
|
14
|
+
.max(20)
|
|
15
|
+
.optional()
|
|
16
|
+
.describe("Override the default bot list. Each entry is a User-Agent token (e.g. 'GPTBot', 'ClaudeBot')."),
|
|
17
|
+
fetch_with_ua: z
|
|
18
|
+
.boolean()
|
|
19
|
+
.default(true)
|
|
20
|
+
.describe("If true, do a live GET as each bot's User-Agent and report status. Disable to only parse robots.txt (no extra requests)."),
|
|
21
|
+
};
|
|
22
|
+
const inputSchema = z.object(crawlerAccessAuditInputSchema);
|
|
23
|
+
// Curated list of the AI crawlers that matter for LLM citation visibility.
|
|
24
|
+
// User-agent tokens are the canonical strings each operator documents.
|
|
25
|
+
const DEFAULT_BOTS = [
|
|
26
|
+
{
|
|
27
|
+
name: "GPTBot",
|
|
28
|
+
ua_token: "GPTBot",
|
|
29
|
+
ua_full: "Mozilla/5.0 (compatible; GPTBot/1.0; +https://openai.com/gptbot)",
|
|
30
|
+
operator: "OpenAI",
|
|
31
|
+
purpose: "ChatGPT training data",
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
name: "OAI-SearchBot",
|
|
35
|
+
ua_token: "OAI-SearchBot",
|
|
36
|
+
ua_full: "Mozilla/5.0 (compatible; OAI-SearchBot/1.0; +https://openai.com/searchbot)",
|
|
37
|
+
operator: "OpenAI",
|
|
38
|
+
purpose: "ChatGPT Search index",
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
name: "ChatGPT-User",
|
|
42
|
+
ua_token: "ChatGPT-User",
|
|
43
|
+
ua_full: "Mozilla/5.0 (compatible; ChatGPT-User/1.0; +https://openai.com/bot)",
|
|
44
|
+
operator: "OpenAI",
|
|
45
|
+
purpose: "Real-time fetch on user prompt",
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
name: "ClaudeBot",
|
|
49
|
+
ua_token: "ClaudeBot",
|
|
50
|
+
ua_full: "Mozilla/5.0 (compatible; ClaudeBot/1.0; +claudebot@anthropic.com)",
|
|
51
|
+
operator: "Anthropic",
|
|
52
|
+
purpose: "Claude training data",
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
name: "Claude-Web",
|
|
56
|
+
ua_token: "Claude-Web",
|
|
57
|
+
ua_full: "Mozilla/5.0 (compatible; Claude-Web/1.0; +https://www.anthropic.com)",
|
|
58
|
+
operator: "Anthropic",
|
|
59
|
+
purpose: "Real-time fetch when Claude browses",
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
name: "PerplexityBot",
|
|
63
|
+
ua_token: "PerplexityBot",
|
|
64
|
+
ua_full: "Mozilla/5.0 (compatible; PerplexityBot/1.0; +https://docs.perplexity.ai/guides/bots)",
|
|
65
|
+
operator: "Perplexity",
|
|
66
|
+
purpose: "Perplexity index",
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
name: "Perplexity-User",
|
|
70
|
+
ua_token: "Perplexity-User",
|
|
71
|
+
ua_full: "Mozilla/5.0 (compatible; Perplexity-User/1.0; +https://docs.perplexity.ai/guides/bots)",
|
|
72
|
+
operator: "Perplexity",
|
|
73
|
+
purpose: "Real-time fetch on user query",
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
name: "CCBot",
|
|
77
|
+
ua_token: "CCBot",
|
|
78
|
+
ua_full: "CCBot/2.0 (https://commoncrawl.org/faq/)",
|
|
79
|
+
operator: "Common Crawl",
|
|
80
|
+
purpose: "Used by many LLM training corpora",
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
name: "Google-Extended",
|
|
84
|
+
ua_token: "Google-Extended",
|
|
85
|
+
ua_full: "Google-Extended",
|
|
86
|
+
operator: "Google",
|
|
87
|
+
purpose: "Gemini training opt-out token (robots-only, no live fetch)",
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
name: "Applebot-Extended",
|
|
91
|
+
ua_token: "Applebot-Extended",
|
|
92
|
+
ua_full: "Applebot-Extended",
|
|
93
|
+
operator: "Apple",
|
|
94
|
+
purpose: "Apple Intelligence training opt-out (robots-only)",
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
name: "Bytespider",
|
|
98
|
+
ua_token: "Bytespider",
|
|
99
|
+
ua_full: "Mozilla/5.0 (compatible; Bytespider; spider-feedback@bytedance.com)",
|
|
100
|
+
operator: "ByteDance",
|
|
101
|
+
purpose: "Doubao/Volcengine LLM training",
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
name: "Meta-ExternalAgent",
|
|
105
|
+
ua_token: "Meta-ExternalAgent",
|
|
106
|
+
ua_full: "meta-externalagent/1.1 (+https://developers.facebook.com/docs/sharing/webmasters/crawler)",
|
|
107
|
+
operator: "Meta",
|
|
108
|
+
purpose: "Llama training data fetch",
|
|
109
|
+
},
|
|
110
|
+
];
|
|
111
|
+
// robots-only (cannot be live-tested because the operator does not actually
|
|
112
|
+
// fetch the URL - it's an opt-out token consumed by their pipeline).
|
|
113
|
+
const ROBOTS_ONLY = new Set(["Google-Extended", "Applebot-Extended"]);
|
|
114
|
+
function robotsUrlFor(target) {
|
|
115
|
+
const u = new URL(target);
|
|
116
|
+
return `${u.protocol}//${u.host}/robots.txt`;
|
|
117
|
+
}
|
|
118
|
+
export async function crawlerAccessAudit(input) {
|
|
119
|
+
const parsed = inputSchema.parse(input);
|
|
120
|
+
log.debug("crawler_access_audit start", { url: parsed.url });
|
|
121
|
+
const robotsUrl = robotsUrlFor(parsed.url);
|
|
122
|
+
let robotsBody = null;
|
|
123
|
+
let robotsStatus = null;
|
|
124
|
+
let robotsError = null;
|
|
125
|
+
try {
|
|
126
|
+
const r = await fetchText(robotsUrl, { timeoutMs: 15_000 });
|
|
127
|
+
robotsStatus = r.status;
|
|
128
|
+
robotsBody = r.status < 400 ? r.text : "";
|
|
129
|
+
}
|
|
130
|
+
catch (err) {
|
|
131
|
+
robotsError = err instanceof Error ? err.message : String(err);
|
|
132
|
+
robotsBody = "";
|
|
133
|
+
}
|
|
134
|
+
const robots = robotsParser(robotsUrl, robotsBody ?? "");
|
|
135
|
+
const botList = parsed.bots
|
|
136
|
+
? parsed.bots.map((token) => {
|
|
137
|
+
const known = DEFAULT_BOTS.find((b) => b.name.toLowerCase() === token.toLowerCase() || b.ua_token === token);
|
|
138
|
+
return (known ?? {
|
|
139
|
+
name: token,
|
|
140
|
+
ua_token: token,
|
|
141
|
+
ua_full: token,
|
|
142
|
+
operator: "unknown",
|
|
143
|
+
purpose: "user-supplied bot",
|
|
144
|
+
});
|
|
145
|
+
})
|
|
146
|
+
: DEFAULT_BOTS;
|
|
147
|
+
const results = await Promise.all(botList.map(async (bot) => {
|
|
148
|
+
let allowed = "unknown";
|
|
149
|
+
try {
|
|
150
|
+
const a = robots.isAllowed(parsed.url, bot.ua_token);
|
|
151
|
+
if (typeof a === "boolean")
|
|
152
|
+
allowed = a;
|
|
153
|
+
}
|
|
154
|
+
catch {
|
|
155
|
+
allowed = "unknown";
|
|
156
|
+
}
|
|
157
|
+
const rule = (() => {
|
|
158
|
+
try {
|
|
159
|
+
// robots-parser exposes the matched rule via getMatchingLineNumber, but
|
|
160
|
+
// not all versions expose it. Keep it simple: report the User-Agent
|
|
161
|
+
// group we matched if any disallow line exists for this bot.
|
|
162
|
+
if (!robotsBody)
|
|
163
|
+
return null;
|
|
164
|
+
const re = new RegExp(`(^|\\n)User-agent:\\s*${bot.ua_token}([\\s\\S]*?)(?=\\n\\s*User-agent:|$)`, "i");
|
|
165
|
+
const m = robotsBody.match(re);
|
|
166
|
+
if (!m)
|
|
167
|
+
return null;
|
|
168
|
+
const block = m[2]
|
|
169
|
+
.split("\n")
|
|
170
|
+
.map((line) => line.trim())
|
|
171
|
+
.filter((line) => /^(allow|disallow|crawl-delay):/i.test(line))
|
|
172
|
+
.join(" | ");
|
|
173
|
+
return block || null;
|
|
174
|
+
}
|
|
175
|
+
catch {
|
|
176
|
+
return null;
|
|
177
|
+
}
|
|
178
|
+
})();
|
|
179
|
+
const isRobotsOnly = ROBOTS_ONLY.has(bot.name);
|
|
180
|
+
if (isRobotsOnly || !parsed.fetch_with_ua) {
|
|
181
|
+
const verdict = allowed === true
|
|
182
|
+
? isRobotsOnly
|
|
183
|
+
? "robots_only_allowed"
|
|
184
|
+
: "allowed"
|
|
185
|
+
: allowed === false
|
|
186
|
+
? isRobotsOnly
|
|
187
|
+
? "robots_only_blocked"
|
|
188
|
+
: "blocked"
|
|
189
|
+
: "unknown";
|
|
190
|
+
return {
|
|
191
|
+
name: bot.name,
|
|
192
|
+
ua_token: bot.ua_token,
|
|
193
|
+
operator: bot.operator,
|
|
194
|
+
purpose: bot.purpose,
|
|
195
|
+
robots_allowed: allowed,
|
|
196
|
+
robots_rule: rule,
|
|
197
|
+
fetch_status: null,
|
|
198
|
+
fetch_ok: null,
|
|
199
|
+
fetch_error: null,
|
|
200
|
+
verdict,
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
// live UA test
|
|
204
|
+
let status = null;
|
|
205
|
+
let err = null;
|
|
206
|
+
try {
|
|
207
|
+
const r = await fetchText(parsed.url, {
|
|
208
|
+
method: "GET",
|
|
209
|
+
headers: { "user-agent": bot.ua_full },
|
|
210
|
+
timeoutMs: 15_000,
|
|
211
|
+
});
|
|
212
|
+
status = r.status;
|
|
213
|
+
}
|
|
214
|
+
catch (e) {
|
|
215
|
+
err = e instanceof Error ? e.message : String(e);
|
|
216
|
+
}
|
|
217
|
+
const fetchOk = status !== null && status < 400;
|
|
218
|
+
const verdict = allowed === false
|
|
219
|
+
? "blocked"
|
|
220
|
+
: fetchOk
|
|
221
|
+
? "allowed"
|
|
222
|
+
: allowed === true
|
|
223
|
+
? "blocked"
|
|
224
|
+
: "unknown";
|
|
225
|
+
return {
|
|
226
|
+
name: bot.name,
|
|
227
|
+
ua_token: bot.ua_token,
|
|
228
|
+
operator: bot.operator,
|
|
229
|
+
purpose: bot.purpose,
|
|
230
|
+
robots_allowed: allowed,
|
|
231
|
+
robots_rule: rule,
|
|
232
|
+
fetch_status: status,
|
|
233
|
+
fetch_ok: fetchOk,
|
|
234
|
+
fetch_error: err,
|
|
235
|
+
verdict,
|
|
236
|
+
};
|
|
237
|
+
}));
|
|
238
|
+
const summary = {
|
|
239
|
+
total: results.length,
|
|
240
|
+
allowed: results.filter((r) => r.verdict === "allowed" || r.verdict === "robots_only_allowed").length,
|
|
241
|
+
blocked: results.filter((r) => r.verdict === "blocked" || r.verdict === "robots_only_blocked").length,
|
|
242
|
+
unknown: results.filter((r) => r.verdict === "unknown").length,
|
|
243
|
+
};
|
|
244
|
+
return {
|
|
245
|
+
url: parsed.url,
|
|
246
|
+
robots_url: robotsUrl,
|
|
247
|
+
robots_status: robotsStatus,
|
|
248
|
+
robots_present: !!(robotsBody && robotsBody.length > 0),
|
|
249
|
+
robots_error: robotsError,
|
|
250
|
+
fetched_at: new Date().toISOString(),
|
|
251
|
+
bots: results,
|
|
252
|
+
summary,
|
|
253
|
+
note: "verdict combines robots.txt parsing with a live GET using each bot's User-Agent (unless fetch_with_ua=false or the bot is opt-out-token only, like Google-Extended). 'blocked' = robots.txt forbids OR the page 4xx/5xx'd under that UA.",
|
|
254
|
+
};
|
|
255
|
+
}
|
|
256
|
+
//# sourceMappingURL=crawler-access-audit.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"crawler-access-audit.js","sourceRoot":"","sources":["../../src/tools/crawler-access-audit.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,7 +5,7 @@ export declare const gscCitationGapInputSchema: {
|
|
|
5
5
|
site_url: z.ZodOptional<z.ZodString>;
|
|
6
6
|
start_date: z.ZodString;
|
|
7
7
|
end_date: z.ZodString;
|
|
8
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
8
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
9
9
|
credentials_path: z.ZodOptional<z.ZodString>;
|
|
10
10
|
};
|
|
11
11
|
declare const inputSchema: z.ZodObject<{
|
|
@@ -14,10 +14,10 @@ declare const inputSchema: z.ZodObject<{
|
|
|
14
14
|
site_url: z.ZodOptional<z.ZodString>;
|
|
15
15
|
start_date: z.ZodString;
|
|
16
16
|
end_date: z.ZodString;
|
|
17
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
17
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
18
18
|
credentials_path: z.ZodOptional<z.ZodString>;
|
|
19
19
|
}, "strip", z.ZodTypeAny, {
|
|
20
|
-
engine: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
20
|
+
engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto";
|
|
21
21
|
domain: string;
|
|
22
22
|
queries: string[];
|
|
23
23
|
start_date: string;
|
|
@@ -29,7 +29,7 @@ declare const inputSchema: z.ZodObject<{
|
|
|
29
29
|
queries: string[];
|
|
30
30
|
start_date: string;
|
|
31
31
|
end_date: string;
|
|
32
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
32
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto" | undefined;
|
|
33
33
|
site_url?: string | undefined;
|
|
34
34
|
credentials_path?: string | undefined;
|
|
35
35
|
}>;
|
|
@@ -48,7 +48,7 @@ export declare function gscCitationGap(input: z.infer<typeof inputSchema>): Prom
|
|
|
48
48
|
start: string;
|
|
49
49
|
end: string;
|
|
50
50
|
};
|
|
51
|
-
engine:
|
|
51
|
+
engine: any;
|
|
52
52
|
rows: {
|
|
53
53
|
query: string;
|
|
54
54
|
gsc: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"gsc-citation-gap.d.ts","sourceRoot":"","sources":["../../src/tools/gsc-citation-gap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,yBAAyB;;;;;;;;CA4BrC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAgDxD,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"gsc-citation-gap.d.ts","sourceRoot":"","sources":["../../src/tools/gsc-citation-gap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,yBAAyB;;;;;;;;CA4BrC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAgDxD,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DtE"}
|
|
@@ -25,7 +25,7 @@ export const gscCitationGapInputSchema = {
|
|
|
25
25
|
.string()
|
|
26
26
|
.describe("ISO date for GSC range end, e.g. '2026-05-01'."),
|
|
27
27
|
engine: z
|
|
28
|
-
.enum(["perplexity", "claude", "openai", "gemini", "
|
|
28
|
+
.enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"])
|
|
29
29
|
.default("auto")
|
|
30
30
|
.describe("AI engine for the citation check."),
|
|
31
31
|
credentials_path: z
|
|
@@ -89,11 +89,16 @@ export async function gscCitationGap(input) {
|
|
|
89
89
|
endDate: parsed.end_date,
|
|
90
90
|
queries: parsed.queries,
|
|
91
91
|
}),
|
|
92
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
92
93
|
amICited({ domain: parsed.domain, queries: parsed.queries, engine: parsed.engine }),
|
|
93
94
|
]);
|
|
95
|
+
// Flatten citation results regardless of single/multi-engine mode.
|
|
96
|
+
const citationResults = citation.mode === "single_engine"
|
|
97
|
+
? citation.results
|
|
98
|
+
: citation.per_engine?.[0]?.results ?? [];
|
|
94
99
|
const rows = parsed.queries.map((q) => {
|
|
95
100
|
const gsc = gscMap.get(q.toLowerCase());
|
|
96
|
-
const cite =
|
|
101
|
+
const cite = citationResults.find((r) => r.query === q);
|
|
97
102
|
return {
|
|
98
103
|
query: q,
|
|
99
104
|
gsc: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"gsc-citation-gap.js","sourceRoot":"","sources":["../../src/tools/gsc-citation-gap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,oGAAoG,CAAC;IACjH,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,4CAA4C,CAAC;IACzD,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"gsc-citation-gap.js","sourceRoot":"","sources":["../../src/tools/gsc-citation-gap.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,19 +2,19 @@ import { z } from "zod";
|
|
|
2
2
|
export declare const runPanelInputSchema: {
|
|
3
3
|
name: z.ZodString;
|
|
4
4
|
domain: z.ZodOptional<z.ZodString>;
|
|
5
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
5
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
6
6
|
};
|
|
7
7
|
declare const inputSchema: z.ZodObject<{
|
|
8
8
|
name: z.ZodString;
|
|
9
9
|
domain: z.ZodOptional<z.ZodString>;
|
|
10
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
10
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
11
11
|
}, "strip", z.ZodTypeAny, {
|
|
12
|
-
engine: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
12
|
+
engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto";
|
|
13
13
|
name: string;
|
|
14
14
|
domain?: string | undefined;
|
|
15
15
|
}, {
|
|
16
16
|
name: string;
|
|
17
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
17
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto" | undefined;
|
|
18
18
|
domain?: string | undefined;
|
|
19
19
|
}>;
|
|
20
20
|
export declare function runPanel(input: z.infer<typeof inputSchema>): Promise<{
|
|
@@ -26,7 +26,7 @@ export declare function runPanel(input: z.infer<typeof inputSchema>): Promise<{
|
|
|
26
26
|
snapshot: {
|
|
27
27
|
panel: string;
|
|
28
28
|
domain: string;
|
|
29
|
-
engine: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
29
|
+
engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto";
|
|
30
30
|
taken_at: string;
|
|
31
31
|
per_query: {
|
|
32
32
|
query: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run-panel.d.ts","sourceRoot":"","sources":["../../src/tools/run-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;CAa/B,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAgC,CAAC;AAElD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;mBAoBhC,MAAM;mBAAS,OAAO;mBAAS,MAAM;2BAAiB,MAAM,EAAE;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"run-panel.d.ts","sourceRoot":"","sources":["../../src/tools/run-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;CAa/B,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAgC,CAAC;AAElD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;mBAoBhC,MAAM;mBAAS,OAAO;mBAAS,MAAM;2BAAiB,MAAM,EAAE;;;;;;;;;GA+B9F"}
|
package/dist/tools/run-panel.js
CHANGED
|
@@ -11,9 +11,9 @@ export const runPanelInputSchema = {
|
|
|
11
11
|
.optional()
|
|
12
12
|
.describe("Override the panel's default domain for this run."),
|
|
13
13
|
engine: z
|
|
14
|
-
.enum(["perplexity", "claude", "openai", "gemini", "
|
|
14
|
+
.enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"])
|
|
15
15
|
.default("auto")
|
|
16
|
-
.describe("AI engine to query."),
|
|
16
|
+
.describe("AI engine to query. Use bing_serp/brave_serp for web_rank comparison only — am_i_cited will refuse them."),
|
|
17
17
|
};
|
|
18
18
|
const inputSchema = z.object(runPanelInputSchema);
|
|
19
19
|
export async function runPanel(input) {
|
|
@@ -37,9 +37,18 @@ export async function runPanel(input) {
|
|
|
37
37
|
let engineUsed = parsed.engine;
|
|
38
38
|
const fetchedAt = new Date().toISOString();
|
|
39
39
|
for (const queries of chunks) {
|
|
40
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
40
41
|
const res = await amICited({ domain, queries, engine: parsed.engine });
|
|
41
|
-
|
|
42
|
-
|
|
42
|
+
// Handle both single-engine and multi-engine return shapes.
|
|
43
|
+
if (res.mode === "single_engine") {
|
|
44
|
+
engineUsed = res.engine;
|
|
45
|
+
perQuery.push(...res.results);
|
|
46
|
+
}
|
|
47
|
+
else {
|
|
48
|
+
engineUsed = res.engines?.[0]?.engine ?? parsed.engine;
|
|
49
|
+
for (const r of (res.per_engine?.[0]?.results ?? []))
|
|
50
|
+
perQuery.push(r);
|
|
51
|
+
}
|
|
43
52
|
}
|
|
44
53
|
const queriesCited = perQuery.filter((q) => q.cited).length;
|
|
45
54
|
const snapshot = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run-panel.js","sourceRoot":"","sources":["../../src/tools/run-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"run-panel.js","sourceRoot":"","sources":["../../src/tools/run-panel.ts"],"names":[],"mappings":"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"}
|