npm - @cloro-dev/seo-provider - Versions diffs - 0.0.0-stage → 0.1.1 - Mend

@cloro-dev/seo-provider 0.0.0-stage → 0.1.1

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.

Files changed (6) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 cloro
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,3 +1,127 @@
-# Temporary Holding Version
+# cloro provider for seo
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Adds [cloro](https://cloro.dev/?utm_source=seo-provider&utm_medium=byok) to
+[`seo`](https://github.com/iannuttall/seo), the SEO command line tool and MCP
+server. With your own cloro API key, `seo` gets:
+- live Google results for `seo research serp`,
+- Google organic results with the pages the AI Overview cites,
+- answers from ChatGPT, Google AI Mode, Gemini and Bing AI Mode, with a check
+  of whether each answer cites your site, mentions it, or neither.
+The package runs only on your machine, in the `seo` CLI and the local MCP
+server (`seo mcp serve`). It has no runtime dependencies and sends every
+request through `seo`, which keeps the key and limits the requests.
+## Requirements
+- Node.js 22.19 or newer
+- `seo` 0.17.3 or newer: `npm install --global seo`
+- A cloro API key. The Free plan has 500 credits a month:
+  [sign up](https://dashboard.cloro.dev/api-keys?utm_source=seo-provider&utm_medium=byok).
+## Install and connect
+```sh
+seo providers install @cloro-dev/seo-provider
+seo providers connect cloro
+```
+`seo providers connect` asks for the API key and stores it. You can also set
+`SEO_CLORO_API_KEY` in the environment. The connection check reads your credit
+balance and costs no credits.
+## Live Google results
+```sh
+seo research serp --provider cloro --keywords "crm software,best crm"
+```
+This uses the `serp-snapshot` capability: one Google search per keyword, by
+country, language and device (desktop or mobile), up to 100 results. It
+queues the search on cloro's async API and reads it until it finishes, up to
+about a minute.
+## Actions
+Run an action with `seo providers run cloro <action> --params '<json>'`.
+Agents run them through `seo_describe_provider` and `seo_run_provider` in the
+local MCP server.
+### serp
+Google organic results and the pages the AI Overview cites, for up to 5
+keywords.
+```sh
+seo providers run cloro serp --params '{"keywords":["best crm for startups"],"country":"US"}'
+```
+Each row has `keyword`, `type` (`organic` or `ai_overview`), `position`,
+`url`, `domain` and `title`.
+### ai-answers
+Asks up to 5 questions on each engine and reports, for each answer, whether
+it cites the site (`cited`), names it (`mentioned`), or `neither`.
+```sh
+seo providers run cloro ai-answers --params '{"domain":"example.com","questions":["what is the best crm for startups"]}'
+```
+| Parameter | What it does |
+| --- | --- |
+| `domain` | The site to look for. Required. |
+| `questions` | 1 to 5 questions. |
+| `engines` | Any of `chatgpt`, `google_ai_mode`, `gemini`, `bing_ai_mode`. Default all four. |
+| `brand` | Names that count as a mention. Default the first part of the domain. |
+| `country` | Two-letter country code. Default `US`. |
+| `waitSeconds` | Seconds to wait before reading the answers. Default 45 (20 for `serp`). |
+| `tasks` | Task ids to read, instead of asking again. |
+Each row has the `question`, the `engine`, the `result`, the cited URL, up to
+8 other cited sites, the date of the answer and the credits it cost.
+### Answers that are not ready
+`serp` and `ai-answers` use cloro's async API. An AI answer can take one to
+three minutes, and `seo` allows 8 requests for each run. An answer that is not
+ready, or not read in this run, comes back with result `pending`, and its task
+id is in `pendingTasks`. Read it later at no cost:
+```sh
+seo providers run cloro ai-answers --params '{"domain":"example.com","tasks":["<task id>"]}'
+```
+cloro keeps a task for 24 hours. A run sent again on the same day with the
+same question gets the same tasks back and is not charged again. `credits`
+in the result is what cloro charged for the tasks in that result.
+## Credits
+| Request | Credits |
+| --- | --- |
+| Google search (`serp-snapshot`) | 3, plus 2 for each page after the first |
+| Google search with AI Overview (`serp`) | 5 |
+| ChatGPT answer | 5 |
+| Google AI Mode, Gemini or Bing AI Mode answer | 4 |
+cloro charges a request only when it succeeds. Plans and prices:
+[cloro.dev/pricing](https://cloro.dev/pricing/?utm_source=seo-provider&utm_medium=byok).
+The cost estimate that `seo` shows uses the highest paid rate per credit
+(Lite plan), so larger plans pay less than the estimate.
+## Development
+```sh
+npm install
+npm run build
+npm run typecheck
+npm test
+```
+The tests use payloads trimmed from live cloro responses.
+## License
+MIT

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { SeoProviderActivate } from "seo/provider-sdk";
+type Item = Record<string, unknown>;
+type Verdict = 'cited' | 'mentioned' | 'neither' | 'no_answer';
+export declare function classify(answer: Item, site: {
+  domain: string;
+  names: string[];
+}): {
+  result: Verdict;
+  citedUrl: string | null;
+  sources: string[];
+  model: string | null;
+};
+declare const activate: SeoProviderActivate;
+export { activate as default };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,789 @@
+import { setTimeout } from "node:timers/promises";
+// src/index.ts
+const API = "https://api.cloro.dev";
+const RESULTS_PER_PAGE = 10;
+const MAX_DEPTH = 100;
+const MICROS_PER_CREDIT = 800;
+const MAX_KEYWORDS = 5;
+const MAX_QUESTIONS = 5;
+const MAX_SOURCES = 8;
+const BING_PROMPT_LIMIT = 3500;
+const ENGINES = {
+	chatgpt: {
+		type: "CHATGPT",
+		credits: 5
+	},
+	google_ai_mode: {
+		type: "AIMODE",
+		credits: 4
+	},
+	gemini: {
+		type: "GEMINI",
+		credits: 4
+	},
+	bing_ai_mode: {
+		type: "BING_AIMODE",
+		credits: 4
+	}
+};
+const ENGINE_NAMES = Object.keys(ENGINES);
+function failure(code, message) {
+	return Object.assign(new Error(message), { code });
+}
+function apiKey(connection) {
+	const value = connection.credentials.apiKey?.trim() ?? "";
+	if (!value || value.length > 4096) throw failure("authentication", "cloro needs a valid API key.");
+	return value;
+}
+function headers(connection) {
+	return {
+		authorization: `Bearer ${apiKey(connection)}`,
+		"content-type": "application/json"
+	};
+}
+const items = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "object" && !!item) : [];
+const text = (value) => typeof value === "string" && value.trim() ? value.trim() : null;
+function country(value) {
+	const code = typeof value === "string" ? value.trim().toUpperCase() : "US";
+	if (!/^[A-Z]{2}$/u.test(code)) throw failure("configuration", "Use a two-letter country code, such as US.");
+	return code;
+}
+function safeUrl(value) {
+	if (typeof value !== "string") return null;
+	try {
+		const parsed = new URL(value);
+		if (!["http:", "https:"].includes(parsed.protocol)) return null;
+		if (/(^|\.)google\.[a-z.]+$/u.test(parsed.hostname) && parsed.pathname.startsWith("/goto")) return null;
+		parsed.username = "";
+		parsed.password = "";
+		return parsed.toString();
+	} catch {
+		return null;
+	}
+}
+const hostOf = (url) => {
+	if (!url) return null;
+	try {
+		return new URL(url).hostname.toLowerCase();
+	} catch {
+		return null;
+	}
+};
+async function verify(connection, runtime) {
+	if (typeof (await runtime.requestJson({
+		operation: "verify",
+		url: `${API}/v1/credits`,
+		headers: headers(connection)
+	}))?.remaining !== "number") throw failure("invalid-response", "cloro returned invalid credit data.");
+}
+function snapshotMarket(value) {
+	if (value.searchEngine !== "google") throw failure("configuration", "cloro SERP snapshots support Google.");
+	if (value.location) throw failure("configuration", "cloro SERP snapshots take country-level markets. Omit the location.");
+	if (!/^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/iu.test(value.languageCode)) throw failure("configuration", "Use a valid language code, such as en.");
+	return {
+		countryCode: country(value.countryCode),
+		languageCode: value.languageCode,
+		device: value.device ?? "desktop"
+	};
+}
+function pagesFor(depth) {
+	if (!Number.isSafeInteger(depth) || depth < 1 || depth > MAX_DEPTH) throw failure("configuration", `cloro SERP depth must be from 1 to ${MAX_DEPTH}.`);
+	return Math.ceil(depth / RESULTS_PER_PAGE);
+}
+const snapshotCredits = (pages) => 3 + 2 * (pages - 1);
+const SNAPSHOT_REQUESTS = 20;
+const POLL_MS = 3e3;
+const snakeCase = (key) => key.replace(/[A-Z]/gu, (letter) => `_${letter.toLowerCase()}`);
+function present(value) {
+	if (value === void 0 || value === null) return false;
+	if (Array.isArray(value)) return value.length > 0;
+	if (typeof value === "string") return value.trim().length > 0;
+	if (typeof value === "object") return Object.keys(value).length > 0;
+	return true;
+}
+async function serpSnapshot(input, runtime) {
+	const keyword = input.keyword.trim().replace(/\s+/gu, " ");
+	if (!keyword || keyword.length > 1e3) throw failure("configuration", "Use a keyword of 1 to 1,000 characters.");
+	const market = snapshotMarket(input.market);
+	const pages = pagesFor(input.depth);
+	const [queued] = await queue(input, runtime, "serp-snapshot:queue", [{
+		taskType: "GOOGLE",
+		payload: {
+			query: keyword,
+			country: market.countryCode,
+			hl: market.languageCode,
+			device: market.device,
+			...pages > 1 ? { pages } : {}
+		}
+	}]);
+	if (!queued || "error" in queued) throw failure("remote-error", queued?.error ?? "cloro queued no task.");
+	let task;
+	for (let read = 1; read < SNAPSHOT_REQUESTS; read += 1) {
+		await setTimeout(POLL_MS);
+		[task] = await readTasks(input, runtime, "serp-snapshot:read", [queued.id]);
+		if (task?.state !== "pending") break;
+	}
+	if (task?.state === "failed") throw failure("remote-error", task.error);
+	if (task?.state !== "done") throw failure("timeout", `cloro did not finish the search in time. Task ${queued.id} keeps the result for 24 hours.`);
+	const result = task.response;
+	const observedAt = runtime.now();
+	const raw = items(result.organicResults);
+	const mapped = raw.flatMap((item) => {
+		const url = safeUrl(item.link);
+		const rank = item.position;
+		if (!url || typeof rank !== "number" || !Number.isSafeInteger(rank)) return [];
+		if (rank < 1) return [];
+		return [{
+			rankGroup: rank,
+			rankAbsolute: rank,
+			page: typeof item.page === "number" ? item.page : Math.ceil(rank / RESULTS_PER_PAGE),
+			domain: hostOf(url) ?? "",
+			url,
+			title: text(item.title),
+			description: text(item.snippet),
+			isFeaturedSnippet: null
+		}];
+	});
+	mapped.sort((left, right) => left.rankAbsolute - right.rankAbsolute || (left.url < right.url ? -1 : left.url > right.url ? 1 : 0));
+	const organicResults = mapped.slice(0, input.depth);
+	const invalidRows = raw.length - mapped.length;
+	const credits = snapshotCredits(pages);
+	const qualityWarnings = [{
+		code: "estimated-monetary-cost",
+		field: "cost.actualMicros",
+		message: `cloro charged ${task.credits} credits. Their money value depends on the plan, so the estimate uses the highest paid rate per credit.`
+	}];
+	if (invalidRows > 0) qualityWarnings.push({
+		code: "invalid-organic-results",
+		field: "organicResults",
+		message: `cloro returned ${invalidRows} organic result${invalidRows === 1 ? "" : "s"} without a valid rank or URL.`
+	});
+	return {
+		observedAt,
+		effectiveKeyword: keyword,
+		searchEngineDomain: null,
+		checkUrl: null,
+		resultCount: null,
+		pagesCount: Math.max(0, ...mapped.map((row) => row.page)) || null,
+		features: [...new Set(Object.entries(result).filter(([key, value]) => key !== "html" && present(value)).map(([key]) => key === "organicResults" ? "organic" : snakeCase(key)))].sort(),
+		organicResults,
+		localPack: {
+			present: false,
+			returnedRows: 0,
+			retainedRows: 0,
+			invalidRows: 0,
+			results: []
+		},
+		coverage: {
+			returnedRows: raw.length,
+			retainedRows: organicResults.length,
+			invalidRows,
+			providerTotalRows: null,
+			completeness: invalidRows > 0 ? "partial" : mapped.length > input.depth ? "capped" : "complete",
+			nextCursor: null
+		},
+		request: {
+			endpoint: "v1/async/task (GOOGLE)",
+			filters: {
+				countryCode: market.countryCode,
+				languageCode: market.languageCode,
+				device: market.device,
+				pages
+			},
+			sort: ["rankAbsolute:ascending", "url:codepoint-ascending"]
+		},
+		cost: {
+			estimatedMicros: credits * MICROS_PER_CREDIT,
+			actualMicros: null,
+			taskIds: [queued.id],
+			native: {
+				unit: "credit",
+				estimatedUnits: credits,
+				actualUnits: task.credits,
+				remainingBefore: null
+			}
+		},
+		qualityWarnings
+	};
+}
+async function queue(connection, runtime, operation, tasks) {
+	const data = await runtime.requestJson({
+		operation,
+		url: `${API}/v1/async/task/batch`,
+		method: "POST",
+		headers: headers(connection),
+		body: JSON.stringify(tasks)
+	});
+	const results = items(data?.results);
+	return tasks.map((_, index) => {
+		const result = results.find((item) => item.index === index);
+		const task = result?.task;
+		if (result?.success === true && typeof task?.id === "string") return { id: task.id };
+		const error = result?.error ?? {};
+		const details = error.details ?? {};
+		if (error.code === "RESOURCE_ALREADY_EXISTS" && typeof details.taskId === "string") return { id: details.taskId };
+		return { error: `cloro: ${text(error.code) ?? "no task"}${text(error.message) ? `, ${text(error.message)}` : ""}` };
+	});
+}
+const LIMIT_REACHED = /exceeded its request limit/u;
+async function readTasks(connection, runtime, operation, ids) {
+	const out = [];
+	let stopped = false;
+	for (const id of ids) {
+		if (stopped) {
+			out.push({
+				state: "pending",
+				id,
+				type: null,
+				key: null
+			});
+			continue;
+		}
+		let data;
+		try {
+			data = await runtime.requestJson({
+				operation,
+				url: `${API}/v1/async/task/${encodeURIComponent(id)}`,
+				headers: headers(connection)
+			});
+		} catch (error) {
+			if (error instanceof Error && LIMIT_REACHED.test(error.message)) {
+				stopped = true;
+				out.push({
+					state: "pending",
+					id,
+					type: null,
+					key: null
+				});
+				continue;
+			}
+			const status = error.status;
+			out.push({
+				state: "failed",
+				id,
+				type: null,
+				key: null,
+				error: status === 404 ? "cloro: the task is gone. cloro keeps a task for 24 hours." : `cloro: ${error instanceof Error ? error.message : String(error)}`.slice(0, 200)
+			});
+			continue;
+		}
+		const task = data?.task ?? {};
+		const status = text(task.status);
+		const type = text(task.taskType);
+		const key = text(task.idempotencyKey);
+		const response = data?.response;
+		if (status === "COMPLETED" && response && typeof response === "object") {
+			const credits = data?.credits ?? {};
+			out.push({
+				state: "done",
+				id,
+				type,
+				key,
+				createdAt: text(task.createdAt),
+				credits: typeof credits.creditsCharged === "number" ? credits.creditsCharged : 0,
+				response
+			});
+		} else if (status === "FAILED") {
+			const error = response?.error ?? {};
+			out.push({
+				state: "failed",
+				id,
+				type,
+				key,
+				error: `cloro: ${text(error.code) ?? "FAILED"}${text(error.message) ? `, ${text(error.message)}` : ""}`.slice(0, 200)
+			});
+		} else out.push({
+			state: "pending",
+			id,
+			type,
+			key
+		});
+	}
+	return out;
+}
+const today = (runtime) => runtime.now().slice(0, 10);
+function stringList(value, name, max) {
+	if (value === void 0) return [];
+	if (!Array.isArray(value)) throw failure("configuration", `${name} must be a list.`);
+	const list = [...new Set(value.map((item) => typeof item === "string" ? item.trim() : ""))].filter(Boolean);
+	if (list.length > max) throw failure("configuration", `${name} takes up to ${max} values.`);
+	return list;
+}
+function waitSeconds(value, fallback) {
+	if (value === void 0) return fallback;
+	if (typeof value !== "number" || !Number.isInteger(value) || value < 0 || value > 120) throw failure("configuration", "waitSeconds must be from 0 to 120.");
+	return value;
+}
+const serpKey = (code, day, keyword) => `seo-serp:${code}:${day}:${keyword}`;
+const keywordOf = (key) => key?.startsWith("seo-serp:") ? key.split(":").slice(3).join(":") : null;
+function serpRows(keyword, result) {
+	const organic = items(result.organicResults).map((item) => {
+		const url = safeUrl(item.link);
+		const site = /^(?:https?:\/\/)?([^/\s›]+)/u.exec(String(item.displayedLink ?? ""));
+		return {
+			keyword,
+			type: "organic",
+			position: typeof item.position === "number" ? item.position : null,
+			url,
+			domain: url ? hostOf(url) : site?.[1] ?? null,
+			title: text(item.title)
+		};
+	});
+	const overview = result.aioverview ?? {};
+	const cited = items(overview.sources).map((source) => {
+		const url = safeUrl(source.url);
+		return {
+			keyword,
+			type: "ai_overview",
+			position: typeof source.position === "number" ? source.position : null,
+			url,
+			domain: hostOf(url),
+			title: text(source.label)
+		};
+	});
+	return [...organic, ...cited];
+}
+async function serpAction(input, runtime) {
+	const { params } = input;
+	const given = stringList(params.tasks, "tasks", 50);
+	const errors = [];
+	let ids;
+	let wait = 0;
+	if (given.length) ids = given;
+	else {
+		const keywords = stringList(params.keywords, "keywords", MAX_KEYWORDS);
+		if (!keywords.length) throw failure("configuration", "Give 1 to 5 keywords, or tasks to read.");
+		const code = country(params.country);
+		const day = today(runtime);
+		const queued = await queue(input, runtime, "serp:queue", keywords.map((keyword) => ({
+			taskType: "GOOGLE",
+			idempotencyKey: serpKey(code, day, keyword),
+			payload: {
+				query: keyword,
+				country: code,
+				include: { aioverview: true }
+			}
+		})));
+		ids = [];
+		queued.forEach((entry, index) => {
+			if ("id" in entry) ids.push(entry.id);
+			else errors.push({
+				keyword: keywords[index] ?? null,
+				task: null,
+				error: entry.error
+			});
+		});
+		wait = waitSeconds(params.waitSeconds, 20);
+	}
+	if (wait && ids.length) await setTimeout(wait * 1e3);
+	const read = await readTasks(input, runtime, "serp:read", ids);
+	const rows = [];
+	const pendingTasks = [];
+	let credits = 0;
+	for (const task of read) if (task.state === "pending") pendingTasks.push(task.id);
+	else if (task.state === "failed") errors.push({
+		keyword: keywordOf(task.key),
+		task: task.id,
+		error: task.error
+	});
+	else {
+		credits += task.credits;
+		rows.push(...serpRows(keywordOf(task.key), task.response));
+	}
+	return {
+		rows,
+		credits,
+		pendingTasks,
+		errors
+	};
+}
+const answerKey = (engine, code, day, question) => `seo-ai-answers:${engine}:${code}:${day}:${question}`;
+const questionOf = (key) => key?.startsWith("seo-ai-answers:") ? key.split(":").slice(4).join(":") : null;
+const engineOf = (type) => ENGINE_NAMES.find((name) => ENGINES[name].type === type) ?? null;
+function siteDomain(value) {
+	const raw = typeof value === "string" ? value.trim().toLowerCase() : "";
+	const domain = hostOf(/^https?:\/\//u.test(raw) ? raw : `https://${raw}`)?.replace(/^www\./u, "") ?? "";
+	if (!domain.includes(".")) throw failure("configuration", "Give the site as a domain, such as example.com.");
+	return domain;
+}
+function onSite(url, domain) {
+	const host = hostOf(url);
+	return !!host && (host === domain || host.endsWith(`.${domain}`));
+}
+const NOT_SOURCES = [
+	"images.openai.com",
+	"gstatic.com",
+	"googleusercontent.com",
+	"ggpht.com",
+	"example.com",
+	"example.org",
+	"example.net"
+];
+const IMAGE = /\.(png|jpe?g|gif|webp|avif|svg)(\?|#|$)/iu;
+function isSource(url) {
+	const host = hostOf(url)?.replace(/^www\./u, "");
+	if (!host || IMAGE.test(url)) return false;
+	if (/(^|\.)google\.[a-z.]+$/u.test(host) && new URL(url).pathname === "/search") return false;
+	return !NOT_SOURCES.some((name) => host === name || host.endsWith(`.${name}`));
+}
+function prose(markdown) {
+	return markdown.replace(/\[([^\]]*)\]\(https?:\/\/[^)]*\)/gu, (_, label) => /^\s*(\d+|[\w-]+(\.[\w-]+)+)\s*$/u.test(label) ? " " : label).replace(/https?:\/\/\S+/gu, " ");
+}
+const escape = (value) => value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+function classify(answer, site) {
+	const markdown = typeof answer.text === "string" ? answer.text : "";
+	const given = items(answer.sources).map((source) => safeUrl(source.url)).filter((url) => !!url);
+	const model = text(answer.model);
+	if (!markdown && !given.length) return {
+		result: "no_answer",
+		citedUrl: null,
+		sources: [],
+		model
+	};
+	const linked = markdown.match(/https?:\/\/[^\s)\]]+/gu) ?? [];
+	const all = [...given, ...linked];
+	const citedUrl = all.find((url) => onSite(url, site.domain)) ?? null;
+	const sources = [...new Set(all.filter((url) => !onSite(url, site.domain) && isSource(url)).map((url) => hostOf(url)?.replace(/^www\./u, "")).filter((host) => !!host))].slice(0, MAX_SOURCES);
+	if (citedUrl) return {
+		result: "cited",
+		citedUrl,
+		sources,
+		model
+	};
+	const words = prose(markdown).toLowerCase();
+	return {
+		result: words.includes(site.domain) || site.names.some((name) => new RegExp(`(^|[^\\p{L}\\p{N}])${escape(name.toLowerCase())}($|[^\\p{L}\\p{N}])`, "u").test(words)) ? "mentioned" : "neither",
+		citedUrl: null,
+		sources,
+		model
+	};
+}
+const bingPromptLength = (prompt) => encodeURIComponent(prompt.trim()).replace(/%20/gu, "+").length;
+async function aiAnswersAction(input, runtime) {
+	const { params } = input;
+	const domain = siteDomain(params.domain);
+	const brand = stringList(params.brand, "brand", 5);
+	const site = {
+		domain,
+		names: brand.length ? brand : [domain.split(".")[0] ?? domain]
+	};
+	const given = stringList(params.tasks, "tasks", 100);
+	const blank = {
+		citedUrl: null,
+		sources: [],
+		model: null,
+		answeredAt: null,
+		credits: 0,
+		task: null,
+		error: null
+	};
+	const rows = [];
+	const ids = [];
+	const asked = /* @__PURE__ */ new Map();
+	let wait = 0;
+	if (given.length) ids.push(...given);
+	else {
+		const questions = stringList(params.questions, "questions", MAX_QUESTIONS);
+		if (!questions.length) throw failure("configuration", "Give 1 to 5 questions, or tasks to read.");
+		const engines = params.engines === void 0 ? ENGINE_NAMES : stringList(params.engines, "engines", ENGINE_NAMES.length).map((name) => {
+			if (!(name in ENGINES)) throw failure("configuration", `Unknown engine ${name}. Use ${ENGINE_NAMES.join(", ")}.`);
+			return name;
+		});
+		const code = country(params.country);
+		const day = today(runtime);
+		const asks = [];
+		for (const question of questions) for (const engine of engines) {
+			if (engine === "bing_ai_mode" && bingPromptLength(question) > BING_PROMPT_LIMIT) {
+				rows.push({
+					question,
+					engine,
+					result: "unavailable",
+					...blank,
+					error: `Bing AI Mode takes up to ${BING_PROMPT_LIMIT} characters after URL encoding.`
+				});
+				continue;
+			}
+			asks.push({
+				question,
+				engine
+			});
+		}
+		(asks.length ? await queue(input, runtime, "ai-answers:queue", asks.map(({ question, engine }) => ({
+			taskType: ENGINES[engine].type,
+			idempotencyKey: answerKey(engine, code, day, question),
+			payload: {
+				prompt: question,
+				country: code
+			}
+		}))) : []).forEach((entry, index) => {
+			const ask = asks[index];
+			if (!ask) return;
+			if ("id" in entry) {
+				ids.push(entry.id);
+				asked.set(entry.id, ask);
+			} else rows.push({
+				...ask,
+				result: "unavailable",
+				...blank,
+				error: entry.error
+			});
+		});
+		wait = waitSeconds(params.waitSeconds, 45);
+	}
+	if (wait && ids.length) await setTimeout(wait * 1e3);
+	for (const task of await readTasks(input, runtime, "ai-answers:read", ids)) if (task.state === "pending") rows.push({
+		question: questionOf(task.key) ?? asked.get(task.id)?.question ?? null,
+		engine: engineOf(task.type) ?? asked.get(task.id)?.engine ?? null,
+		result: "pending",
+		...blank,
+		task: task.id
+	});
+	else if (task.state === "failed") rows.push({
+		question: questionOf(task.key),
+		engine: engineOf(task.type),
+		result: "unavailable",
+		...blank,
+		task: task.id,
+		error: task.error
+	});
+	else rows.push({
+		question: questionOf(task.key),
+		engine: engineOf(task.type),
+		...blank,
+		...classify(task.response, site),
+		answeredAt: task.createdAt?.slice(0, 10) ?? null,
+		credits: task.credits,
+		task: task.id
+	});
+	return {
+		domain,
+		rows,
+		credits: rows.reduce((total, row) => total + row.credits, 0),
+		pendingTasks: rows.flatMap((row) => row.result === "pending" && row.task ? [row.task] : [])
+	};
+}
+const nullable = (type) => ({ type: [type, "null"] });
+const strings = (maxItems, description) => ({
+	type: "array",
+	items: {
+		type: "string",
+		minLength: 1,
+		maxLength: 2e3
+	},
+	minItems: 1,
+	maxItems,
+	description
+});
+const commonParams = {
+	country: {
+		type: "string",
+		pattern: "^[A-Za-z]{2}$",
+		description: "Two-letter country code. Default US."
+	},
+	waitSeconds: {
+		type: "integer",
+		minimum: 0,
+		maximum: 120,
+		description: "Seconds to wait for queued tasks before reading them."
+	}
+};
+const serp = {
+	id: "serp",
+	description: "Google organic results and the pages the AI Overview cites, for up to 5 keywords. Results not ready come back as pendingTasks: run again with tasks to read them.",
+	inputSchema: {
+		type: "object",
+		properties: {
+			keywords: strings(MAX_KEYWORDS, "Keywords to search, 1 to 5."),
+			tasks: strings(50, "Task ids from pendingTasks, to read instead of searching."),
+			...commonParams
+		},
+		additionalProperties: false
+	},
+	outputSchema: {
+		type: "object",
+		properties: {
+			rows: {
+				type: "array",
+				items: {
+					type: "object",
+					properties: {
+						keyword: nullable("string"),
+						type: {
+							type: "string",
+							enum: ["organic", "ai_overview"]
+						},
+						position: nullable("number"),
+						url: nullable("string"),
+						domain: nullable("string"),
+						title: nullable("string")
+					},
+					required: [
+						"keyword",
+						"type",
+						"position",
+						"url",
+						"domain",
+						"title"
+					]
+				}
+			},
+			credits: { type: "number" },
+			pendingTasks: {
+				type: "array",
+				items: { type: "string" }
+			},
+			errors: {
+				type: "array",
+				items: {
+					type: "object",
+					properties: {
+						keyword: nullable("string"),
+						task: nullable("string"),
+						error: { type: "string" }
+					},
+					required: [
+						"keyword",
+						"task",
+						"error"
+					]
+				}
+			}
+		},
+		required: [
+			"rows",
+			"credits",
+			"pendingTasks",
+			"errors"
+		]
+	},
+	run: serpAction
+};
+const aiAnswers = {
+	id: "ai-answers",
+	description: "Ask ChatGPT, Google AI Mode, Gemini and Bing AI Mode up to 5 questions and report if each answer cites the site, mentions it, or neither. Answers not ready come back as pendingTasks.",
+	inputSchema: {
+		type: "object",
+		properties: {
+			domain: {
+				type: "string",
+				minLength: 3,
+				maxLength: 253,
+				description: "The site to look for, such as example.com."
+			},
+			questions: strings(MAX_QUESTIONS, "Questions to ask, 1 to 5."),
+			engines: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: ENGINE_NAMES
+				},
+				minItems: 1,
+				maxItems: ENGINE_NAMES.length,
+				description: "Engines to ask. Default all four."
+			},
+			brand: strings(5, "Names that count as a mention. Default the first label of the domain."),
+			tasks: strings(100, "Task ids from pendingTasks, to read instead of asking."),
+			...commonParams
+		},
+		required: ["domain"],
+		additionalProperties: false
+	},
+	outputSchema: {
+		type: "object",
+		properties: {
+			domain: { type: "string" },
+			rows: {
+				type: "array",
+				items: {
+					type: "object",
+					properties: {
+						question: nullable("string"),
+						engine: nullable("string"),
+						result: {
+							type: "string",
+							enum: [
+								"cited",
+								"mentioned",
+								"neither",
+								"no_answer",
+								"pending",
+								"unavailable"
+							]
+						},
+						citedUrl: nullable("string"),
+						sources: {
+							type: "array",
+							items: { type: "string" }
+						},
+						model: nullable("string"),
+						answeredAt: nullable("string"),
+						credits: { type: "number" },
+						task: nullable("string"),
+						error: nullable("string")
+					},
+					required: [
+						"question",
+						"engine",
+						"result",
+						"citedUrl",
+						"sources",
+						"model",
+						"answeredAt",
+						"credits",
+						"task",
+						"error"
+					]
+				}
+			},
+			credits: { type: "number" },
+			pendingTasks: {
+				type: "array",
+				items: { type: "string" }
+			}
+		},
+		required: [
+			"domain",
+			"rows",
+			"credits",
+			"pendingTasks"
+		]
+	},
+	run: aiAnswersAction
+};
+const activate = (host) => {
+	host.registerProvider({
+		id: "cloro",
+		displayName: "cloro",
+		description: "Live Google results, AI Overview sources and answers from ChatGPT, Google AI Mode, Gemini and Bing AI Mode, from cloro.",
+		kinds: ["search-results", "ai-data"],
+		connection: {
+			fields: [{
+				id: "apiKey",
+				label: "API key",
+				kind: "secret",
+				required: true,
+				envVar: "SEO_CLORO_API_KEY"
+			}],
+			verify,
+			verificationNotice: "The connection check reads the credit balance. It costs no credits."
+		},
+		capabilities: [{
+			id: "serp-snapshot",
+			defaultDepth: 10,
+			maxDepth: MAX_DEPTH,
+			maxRequests: SNAPSHOT_REQUESTS,
+			markets: [{
+				searchEngines: ["google"],
+				devices: ["desktop", "mobile"],
+				location: "country-only"
+			}],
+			estimateCostMicros: ({ depth }) => snapshotCredits(pagesFor(depth)) * MICROS_PER_CREDIT,
+			estimateRequests: () => SNAPSHOT_REQUESTS,
+			run: serpSnapshot
+		}],
+		actions: [serp, aiAnswers]
+	});
+};
+export { classify, activate as default };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","names":["sleep"],"sources":["../src/index.ts"],"sourcesContent":["import { setTimeout as sleep } from 'node:timers/promises'\nimport type {\n SeoProviderActionAdapter,\n SeoProviderActivate,\n SeoProviderConnection,\n SeoProviderJson,\n SeoProviderRuntime,\n SeoSearchMarket,\n SeoSerpOrganicResult,\n SeoSerpSnapshotResult,\n} from 'seo/provider-sdk'\n\nconst API = 'https://api.cloro.dev'\nconst RESULTS_PER_PAGE = 10\nconst MAX_DEPTH = 100\n// The Lite plan rate ($30 for 37,500 credits), the highest per-credit rate\n// of the paid plans. Larger plans pay less, so the estimate is an upper\n// bound.\nconst MICROS_PER_CREDIT = 800\nconst MAX_KEYWORDS = 5\nconst MAX_QUESTIONS = 5\nconst MAX_SOURCES = 8\n// Bing AI Mode refuses a prompt longer than this after URL encoding.\nconst BING_PROMPT_LIMIT = 3_500\n\n// cloro's AI engines, by the taskType of its async API, with the credits\n// one answer costs.\nconst ENGINES = {\n chatgpt: { type: 'CHATGPT', credits: 5 },\n google_ai_mode: { type: 'AIMODE', credits: 4 },\n gemini: { type: 'GEMINI', credits: 4 },\n bing_ai_mode: { type: 'BING_AIMODE', credits: 4 },\n} as const\ntype EngineName = keyof typeof ENGINES\nconst ENGINE_NAMES = Object.keys(ENGINES) as EngineName[]\n\ntype Item = Record<string, unknown>\n\nfunction failure(code: string, message: string): Error {\n return Object.assign(new Error(message), { code })\n}\n\nfunction apiKey(connection: SeoProviderConnection): string {\n const value = connection.credentials.apiKey?.trim() ?? ''\n if (!value || value.length > 4_096) {\n throw failure('authentication', 'cloro needs a valid API key.')\n }\n return value\n}\n\nfunction headers(connection: SeoProviderConnection): Record<string, string> {\n return {\n authorization: `Bearer ${apiKey(connection)}`,\n 'content-type': 'application/json',\n }\n}\n\nconst items = (value: unknown): Item[] =>\n Array.isArray(value)\n ? value.filter((item): item is Item => typeof item === 'object' && !!item)\n : []\nconst text = (value: unknown): string | null =>\n typeof value === 'string' && value.trim() ? value.trim() : null\n\nfunction country(value: unknown): string {\n const code = typeof value === 'string' ? value.trim().toUpperCase() : 'US'\n if (!/^[A-Z]{2}$/u.test(code)) {\n throw failure('configuration', 'Use a two-letter country code, such as US.')\n }\n return code\n}\n\n// An http(s) URL, or null. A link cloro could not resolve comes back empty\n// or as a Google /goto redirect.\nfunction safeUrl(value: unknown): string | null {\n if (typeof value !== 'string') return null\n try {\n const parsed = new URL(value)\n if (!['http:', 'https:'].includes(parsed.protocol)) return null\n if (\n /(^|\\.)google\\.[a-z.]+$/u.test(parsed.hostname) &&\n parsed.pathname.startsWith('/goto')\n ) {\n return null\n }\n parsed.username = ''\n parsed.password = ''\n return parsed.toString()\n } catch {\n return null\n }\n}\n\nconst hostOf = (url: string | null): string | null => {\n if (!url) return null\n try {\n return new URL(url).hostname.toLowerCase()\n } catch {\n return null\n }\n}\n\n// --- Connection ------------------------------------------------------------\n\nasync function verify(\n connection: SeoProviderConnection,\n runtime: SeoProviderRuntime,\n): Promise<void> {\n const credits = (await runtime.requestJson({\n operation: 'verify',\n url: `${API}/v1/credits`,\n headers: headers(connection),\n })) as Item | null\n if (typeof credits?.remaining !== 'number') {\n throw failure('invalid-response', 'cloro returned invalid credit data.')\n }\n}\n\n// --- SERP snapshot ------------------------------------------------------------\n// One async Google task, read until it finishes. A sync request can take\n// longer than the host's 15-second request timeout when cloro retries, and\n// the async API costs 2 credits less.\n\nfunction snapshotMarket(value: SeoSearchMarket) {\n if (value.searchEngine !== 'google') {\n throw failure('configuration', 'cloro SERP snapshots support Google.')\n }\n if (value.location) {\n throw failure(\n 'configuration',\n 'cloro SERP snapshots take country-level markets. Omit the location.',\n )\n }\n if (!/^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/iu.test(value.languageCode)) {\n throw failure('configuration', 'Use a valid language code, such as en.')\n }\n return {\n countryCode: country(value.countryCode),\n languageCode: value.languageCode,\n device: value.device ?? 'desktop',\n }\n}\n\nfunction pagesFor(depth: number): number {\n if (!Number.isSafeInteger(depth) || depth < 1 || depth > MAX_DEPTH) {\n throw failure(\n 'configuration',\n `cloro SERP depth must be from 1 to ${MAX_DEPTH}.`,\n )\n }\n return Math.ceil(depth / RESULTS_PER_PAGE)\n}\n\n// An async Google search costs 3 credits, plus 2 for each page after the\n// first.\nconst snapshotCredits = (pages: number) => 3 + 2 * (pages - 1)\n// The capability's request budget: one to queue, the rest to read.\nconst SNAPSHOT_REQUESTS = 20\nconst POLL_MS = 3_000\n\nconst snakeCase = (key: string) =>\n key.replace(/[A-Z]/gu, (letter) => `_${letter.toLowerCase()}`)\n\nfunction present(value: unknown): boolean {\n if (value === undefined || value === null) return false\n if (Array.isArray(value)) return value.length > 0\n if (typeof value === 'string') return value.trim().length > 0\n if (typeof value === 'object') return Object.keys(value).length > 0\n return true\n}\n\nasync function serpSnapshot(\n input: SeoProviderConnection & {\n keyword: string\n market: SeoSearchMarket\n depth: number\n },\n runtime: SeoProviderRuntime,\n): Promise<SeoSerpSnapshotResult> {\n const keyword = input.keyword.trim().replace(/\\s+/gu, ' ')\n if (!keyword || keyword.length > 1_000) {\n throw failure('configuration', 'Use a keyword of 1 to 1,000 characters.')\n }\n const market = snapshotMarket(input.market)\n const pages = pagesFor(input.depth)\n const [queued] = await queue(input, runtime, 'serp-snapshot:queue', [\n {\n taskType: 'GOOGLE',\n payload: {\n query: keyword,\n country: market.countryCode,\n hl: market.languageCode,\n device: market.device,\n ...(pages > 1 ? { pages } : {}),\n },\n },\n ])\n if (!queued || 'error' in queued) {\n throw failure('remote-error', queued?.error ?? 'cloro queued no task.')\n }\n let task: ReadTask | undefined\n for (let read = 1; read < SNAPSHOT_REQUESTS; read += 1) {\n await sleep(POLL_MS)\n ;[task] = await readTasks(input, runtime, 'serp-snapshot:read', [queued.id])\n if (task?.state !== 'pending') break\n }\n if (task?.state === 'failed') throw failure('remote-error', task.error)\n if (task?.state !== 'done') {\n throw failure(\n 'timeout',\n `cloro did not finish the search in time. Task ${queued.id} keeps the result for 24 hours.`,\n )\n }\n const result = task.response\n const observedAt = runtime.now()\n const raw = items(result.organicResults)\n const mapped = raw.flatMap((item): SeoSerpOrganicResult[] => {\n const url = safeUrl(item.link)\n const rank = item.position\n if (!url || typeof rank !== 'number' || !Number.isSafeInteger(rank)) {\n return []\n }\n if (rank < 1) return []\n return [\n {\n rankGroup: rank,\n rankAbsolute: rank,\n page:\n typeof item.page === 'number'\n ? item.page\n : Math.ceil(rank / RESULTS_PER_PAGE),\n domain: hostOf(url) ?? '',\n url,\n title: text(item.title),\n description: text(item.snippet),\n isFeaturedSnippet: null,\n },\n ]\n })\n mapped.sort(\n (left, right) =>\n left.rankAbsolute - right.rankAbsolute ||\n (left.url < right.url ? -1 : left.url > right.url ? 1 : 0),\n )\n const organicResults = mapped.slice(0, input.depth)\n const invalidRows = raw.length - mapped.length\n const credits = snapshotCredits(pages)\n const qualityWarnings: SeoSerpSnapshotResult['qualityWarnings'][number][] = [\n {\n code: 'estimated-monetary-cost',\n field: 'cost.actualMicros',\n message: `cloro charged ${task.credits} credits. Their money value depends on the plan, so the estimate uses the highest paid rate per credit.`,\n },\n ]\n if (invalidRows > 0) {\n qualityWarnings.push({\n code: 'invalid-organic-results',\n field: 'organicResults',\n message: `cloro returned ${invalidRows} organic result${invalidRows === 1 ? '' : 's'} without a valid rank or URL.`,\n })\n }\n return {\n observedAt,\n effectiveKeyword: keyword,\n searchEngineDomain: null,\n checkUrl: null,\n resultCount: null,\n pagesCount: Math.max(0, ...mapped.map((row) => row.page)) || null,\n features: [\n ...new Set(\n Object.entries(result)\n .filter(([key, value]) => key !== 'html' && present(value))\n .map(([key]) =>\n key === 'organicResults' ? 'organic' : snakeCase(key),\n ),\n ),\n ].sort(),\n organicResults,\n localPack: {\n present: false,\n returnedRows: 0,\n retainedRows: 0,\n invalidRows: 0,\n results: [],\n },\n coverage: {\n returnedRows: raw.length,\n retainedRows: organicResults.length,\n invalidRows,\n providerTotalRows: null,\n completeness:\n invalidRows > 0\n ? 'partial'\n : mapped.length > input.depth\n ? 'capped'\n : 'complete',\n nextCursor: null,\n },\n request: {\n endpoint: 'v1/async/task (GOOGLE)',\n filters: {\n countryCode: market.countryCode,\n languageCode: market.languageCode,\n device: market.device,\n pages,\n },\n sort: ['rankAbsolute:ascending', 'url:codepoint-ascending'],\n },\n cost: {\n estimatedMicros: credits * MICROS_PER_CREDIT,\n actualMicros: null,\n taskIds: [queued.id],\n native: {\n unit: 'credit',\n estimatedUnits: credits,\n actualUnits: task.credits,\n remainingBefore: null,\n },\n },\n qualityWarnings,\n }\n}\n\n// --- Async tasks (serp and ai-answers actions) -----------------------------\n\ntype QueuedTask = {\n taskType: string\n idempotencyKey?: string\n payload: Record<string, unknown>\n}\n\n// Queues up to 500 tasks in one request. Each entry is the task id, or why\n// cloro refused the task. A task whose idempotency key was used before comes\n// back as that earlier task, so a run sent again on the same day does not\n// queue or charge twice. cloro charges a task only when it finishes.\nasync function queue(\n connection: SeoProviderConnection,\n runtime: SeoProviderRuntime,\n operation: string,\n tasks: QueuedTask[],\n): Promise<({ id: string } | { error: string })[]> {\n const data = (await runtime.requestJson({\n operation,\n url: `${API}/v1/async/task/batch`,\n method: 'POST',\n headers: headers(connection),\n body: JSON.stringify(tasks),\n })) as Item | null\n const results = items(data?.results)\n return tasks.map((_, index) => {\n const result = results.find((item) => item.index === index)\n const task = result?.task as Item | undefined\n if (result?.success === true && typeof task?.id === 'string') {\n return { id: task.id }\n }\n const error = (result?.error ?? {}) as Item\n const details = (error.details ?? {}) as Item\n if (\n error.code === 'RESOURCE_ALREADY_EXISTS' &&\n typeof details.taskId === 'string'\n ) {\n return { id: details.taskId }\n }\n return {\n error: `cloro: ${text(error.code) ?? 'no task'}${text(error.message) ? `, ${text(error.message)}` : ''}`,\n }\n })\n}\n\ntype ReadTask =\n | {\n state: 'done'\n id: string\n type: string | null\n key: string | null\n createdAt: string | null\n credits: number\n response: Item\n }\n | {\n state: 'failed'\n id: string\n type: string | null\n key: string | null\n error: string\n }\n | { state: 'pending'; id: string; type: string | null; key: string | null }\n\nconst LIMIT_REACHED = /exceeded its request limit/u\n\n// Reads queued tasks one request each, until the host's request limit for\n// this run. A task that is not read, or not finished, stays pending.\n// Reading a task costs no credits. cloro deletes a task 24 hours after it\n// was created.\nasync function readTasks(\n connection: SeoProviderConnection,\n runtime: SeoProviderRuntime,\n operation: string,\n ids: string[],\n): Promise<ReadTask[]> {\n const out: ReadTask[] = []\n let stopped = false\n for (const id of ids) {\n if (stopped) {\n out.push({ state: 'pending', id, type: null, key: null })\n continue\n }\n let data: Item | null\n try {\n data = (await runtime.requestJson({\n operation,\n url: `${API}/v1/async/task/${encodeURIComponent(id)}`,\n headers: headers(connection),\n })) as Item | null\n } catch (error) {\n if (error instanceof Error && LIMIT_REACHED.test(error.message)) {\n stopped = true\n out.push({ state: 'pending', id, type: null, key: null })\n continue\n }\n const status = (error as { status?: unknown }).status\n out.push({\n state: 'failed',\n id,\n type: null,\n key: null,\n error:\n status === 404\n ? 'cloro: the task is gone. cloro keeps a task for 24 hours.'\n : `cloro: ${error instanceof Error ? error.message : String(error)}`.slice(\n 0,\n 200,\n ),\n })\n continue\n }\n const task = (data?.task ?? {}) as Item\n const status = text(task.status)\n const type = text(task.taskType)\n const key = text(task.idempotencyKey)\n const response = data?.response as Item | undefined\n if (status === 'COMPLETED' && response && typeof response === 'object') {\n const credits = (data?.credits ?? {}) as Item\n out.push({\n state: 'done',\n id,\n type,\n key,\n createdAt: text(task.createdAt),\n credits:\n typeof credits.creditsCharged === 'number'\n ? credits.creditsCharged\n : 0,\n response,\n })\n } else if (status === 'FAILED') {\n const error = (response?.error ?? {}) as Item\n out.push({\n state: 'failed',\n id,\n type,\n key,\n error:\n `cloro: ${text(error.code) ?? 'FAILED'}${text(error.message) ? `, ${text(error.message)}` : ''}`.slice(\n 0,\n 200,\n ),\n })\n } else {\n out.push({ state: 'pending', id, type, key })\n }\n }\n return out\n}\n\nconst today = (runtime: SeoProviderRuntime) => runtime.now().slice(0, 10)\n\nfunction stringList(\n value: SeoProviderJson | undefined,\n name: string,\n max: number,\n): string[] {\n if (value === undefined) return []\n if (!Array.isArray(value)) throw failure('configuration', `${name} must be a list.`)\n const list = [\n ...new Set(\n value.map((item) => (typeof item === 'string' ? item.trim() : '')),\n ),\n ].filter(Boolean)\n if (list.length > max) {\n throw failure('configuration', `${name} takes up to ${max} values.`)\n }\n return list\n}\n\nfunction waitSeconds(value: SeoProviderJson | undefined, fallback: number) {\n if (value === undefined) return fallback\n if (\n typeof value !== 'number' ||\n !Number.isInteger(value) ||\n value < 0 ||\n value > 120\n ) {\n throw failure('configuration', 'waitSeconds must be from 0 to 120.')\n }\n return value\n}\n\n// --- serp action -------------------------------------------------------------\n\n// The idempotency key carries the keyword, because cloro does not return a\n// task's payload: answers read back later still know their keyword.\nconst serpKey = (code: string, day: string, keyword: string) =>\n `seo-serp:${code}:${day}:${keyword}`\nconst keywordOf = (key: string | null) =>\n key?.startsWith('seo-serp:') ? key.split(':').slice(3).join(':') : null\n\ntype SerpRow = {\n keyword: string | null\n type: 'organic' | 'ai_overview'\n position: number | null\n url: string | null\n domain: string | null\n title: string | null\n}\n\nfunction serpRows(keyword: string | null, result: Item): SerpRow[] {\n const organic = items(result.organicResults).map((item): SerpRow => {\n const url = safeUrl(item.link)\n // Without the page, the displayed link still shows the site.\n const site = /^(?:https?:\\/\\/)?([^/\\s›]+)/u.exec(\n String(item.displayedLink ?? ''),\n )\n return {\n keyword,\n type: 'organic',\n position: typeof item.position === 'number' ? item.position : null,\n url,\n domain: url ? hostOf(url) : (site?.[1] ?? null),\n title: text(item.title),\n }\n })\n const overview = (result.aioverview ?? {}) as Item\n const cited = items(overview.sources).map((source): SerpRow => {\n const url = safeUrl(source.url)\n return {\n keyword,\n type: 'ai_overview',\n position: typeof source.position === 'number' ? source.position : null,\n url,\n domain: hostOf(url),\n title: text(source.label),\n }\n })\n return [...organic, ...cited]\n}\n\nasync function serpAction(\n input: SeoProviderConnection & {\n params: Readonly<Record<string, SeoProviderJson>>\n },\n runtime: SeoProviderRuntime,\n) {\n const { params } = input\n const given = stringList(params.tasks, 'tasks', 50)\n const errors: { keyword: string | null; task: string | null; error: string }[] =\n []\n let ids: string[]\n let wait = 0\n if (given.length) {\n ids = given\n } else {\n const keywords = stringList(params.keywords, 'keywords', MAX_KEYWORDS)\n if (!keywords.length) {\n throw failure('configuration', 'Give 1 to 5 keywords, or tasks to read.')\n }\n const code = country(params.country)\n const day = today(runtime)\n const queued = await queue(\n input,\n runtime,\n 'serp:queue',\n keywords.map((keyword) => ({\n taskType: 'GOOGLE',\n idempotencyKey: serpKey(code, day, keyword),\n payload: { query: keyword, country: code, include: { aioverview: true } },\n })),\n )\n ids = []\n queued.forEach((entry, index) => {\n if ('id' in entry) ids.push(entry.id)\n else errors.push({ keyword: keywords[index] ?? null, task: null, error: entry.error })\n })\n wait = waitSeconds(params.waitSeconds, 20)\n }\n if (wait && ids.length) await sleep(wait * 1_000)\n const read = await readTasks(input, runtime, 'serp:read', ids)\n const rows: SerpRow[] = []\n const pendingTasks: string[] = []\n let credits = 0\n for (const task of read) {\n if (task.state === 'pending') pendingTasks.push(task.id)\n else if (task.state === 'failed') {\n errors.push({ keyword: keywordOf(task.key), task: task.id, error: task.error })\n } else {\n credits += task.credits\n rows.push(...serpRows(keywordOf(task.key), task.response))\n }\n }\n return { rows, credits, pendingTasks, errors }\n}\n\n// --- ai-answers action -------------------------------------------------------\n\nconst answerKey = (\n engine: string,\n code: string,\n day: string,\n question: string,\n) => `seo-ai-answers:${engine}:${code}:${day}:${question}`\nconst questionOf = (key: string | null) =>\n key?.startsWith('seo-ai-answers:') ? key.split(':').slice(4).join(':') : null\nconst engineOf = (type: string | null): EngineName | null =>\n ENGINE_NAMES.find((name) => ENGINES[name].type === type) ?? null\n\n// The registrable part of a site: \"https://www.example.com/x\" -> example.com.\nfunction siteDomain(value: unknown): string {\n const raw = typeof value === 'string' ? value.trim().toLowerCase() : ''\n const host = hostOf(/^https?:\\/\\//u.test(raw) ? raw : `https://${raw}`)\n const domain = host?.replace(/^www\\./u, '') ?? ''\n if (!domain.includes('.')) {\n throw failure('configuration', 'Give the site as a domain, such as example.com.')\n }\n return domain\n}\n\nfunction onSite(url: string, domain: string): boolean {\n const host = hostOf(url)\n return !!host && (host === domain || host.endsWith(`.${domain}`))\n}\n\n// Hosts that show up in answers without being a source: image hosts, CDNs\n// and placeholder domains written into examples.\nconst NOT_SOURCES = [\n 'images.openai.com',\n 'gstatic.com',\n 'googleusercontent.com',\n 'ggpht.com',\n 'example.com',\n 'example.org',\n 'example.net',\n]\nconst IMAGE = /\\.(png|jpe?g|gif|webp|avif|svg)(\\?|#|$)/iu\n\nfunction isSource(url: string): boolean {\n const host = hostOf(url)?.replace(/^www\\./u, '')\n if (!host || IMAGE.test(url)) return false\n // AI Mode can cite a Google shopping search. It is not a source.\n if (/(^|\\.)google\\.[a-z.]+$/u.test(host) && new URL(url).pathname === '/search') {\n return false\n }\n return !NOT_SOURCES.some((name) => host === name || host.endsWith(`.${name}`))\n}\n\n// The answer's own words: citation pills such as [1](url) or\n// [example.com](url) and bare links go, so a citation is never also counted\n// as a mention by name.\nfunction prose(markdown: string): string {\n return markdown\n .replace(/\\[([^\\]]*)\\]\$https?:\\/\\/[^)]*\$/gu, (_, label: string) =>\n /^\\s*(\\d+|[\\w-]+(\\.[\\w-]+)+)\\s*$/u.test(label) ? ' ' : label,\n )\n .replace(/https?:\\/\\/\\S+/gu, ' ')\n}\n\nconst escape = (value: string) => value.replace(/[.*+?^${}()|[\\]\\\\]/gu, '\\\\$&')\n\ntype Verdict = 'cited' | 'mentioned' | 'neither' | 'no_answer'\n\n// What one answer says about the site: cited (a source or a link in the\n// text is on the site), mentioned (the text names the site or the brand),\n// neither, or no_answer.\nexport function classify(\n answer: Item,\n site: { domain: string; names: string[] },\n): {\n result: Verdict\n citedUrl: string | null\n sources: string[]\n model: string | null\n} {\n const markdown = typeof answer.text === 'string' ? answer.text : ''\n // Every source counts. ChatGPT sources carry a footnote flag, but links\n // written into the text came back with it too.\n const given = items(answer.sources)\n .map((source) => safeUrl(source.url))\n .filter((url): url is string => !!url)\n const model = text(answer.model)\n if (!markdown && !given.length) {\n return { result: 'no_answer', citedUrl: null, sources: [], model }\n }\n const linked = markdown.match(/https?:\\/\\/[^\\s)\\]]+/gu) ?? []\n const all = [...given, ...linked]\n const citedUrl = all.find((url) => onSite(url, site.domain)) ?? null\n const sources = [\n ...new Set(\n all\n .filter((url) => !onSite(url, site.domain) && isSource(url))\n .map((url) => hostOf(url)?.replace(/^www\\./u, ''))\n .filter((host): host is string => !!host),\n ),\n ].slice(0, MAX_SOURCES)\n if (citedUrl) return { result: 'cited', citedUrl, sources, model }\n const words = prose(markdown).toLowerCase()\n const mentioned =\n words.includes(site.domain) ||\n site.names.some((name) =>\n new RegExp(`(^|[^\\\\p{L}\\\\p{N}])${escape(name.toLowerCase())}($|[^\\\\p{L}\\\\p{N}])`, 'u').test(words),\n )\n return { result: mentioned ? 'mentioned' : 'neither', citedUrl: null, sources, model }\n}\n\n// Bing AI Mode counts the prompt after URL encoding, with a space as \"+\".\nconst bingPromptLength = (prompt: string) =>\n encodeURIComponent(prompt.trim()).replace(/%20/gu, '+').length\n\ntype AnswerRow = {\n question: string | null\n engine: EngineName | null\n result: Verdict | 'pending' | 'unavailable'\n citedUrl: string | null\n sources: string[]\n model: string | null\n answeredAt: string | null\n credits: number\n task: string | null\n error: string | null\n}\n\nasync function aiAnswersAction(\n input: SeoProviderConnection & {\n params: Readonly<Record<string, SeoProviderJson>>\n },\n runtime: SeoProviderRuntime,\n) {\n const { params } = input\n const domain = siteDomain(params.domain)\n const brand = stringList(params.brand, 'brand', 5)\n const site = { domain, names: brand.length ? brand : [domain.split('.')[0] ?? domain] }\n const given = stringList(params.tasks, 'tasks', 100)\n const blank = {\n citedUrl: null,\n sources: [],\n model: null,\n answeredAt: null,\n credits: 0,\n task: null,\n error: null,\n }\n const rows: AnswerRow[] = []\n const ids: string[] = []\n // What each task queued in this run asks, for tasks not read yet.\n const asked = new Map<string, { question: string; engine: EngineName }>()\n let wait = 0\n if (given.length) {\n ids.push(...given)\n } else {\n const questions = stringList(params.questions, 'questions', MAX_QUESTIONS)\n if (!questions.length) {\n throw failure('configuration', 'Give 1 to 5 questions, or tasks to read.')\n }\n const engines = params.engines === undefined\n ? ENGINE_NAMES\n : stringList(params.engines, 'engines', ENGINE_NAMES.length).map((name) => {\n if (!(name in ENGINES)) {\n throw failure(\n 'configuration',\n `Unknown engine ${name}. Use ${ENGINE_NAMES.join(', ')}.`,\n )\n }\n return name as EngineName\n })\n const code = country(params.country)\n const day = today(runtime)\n const asks: { question: string; engine: EngineName }[] = []\n for (const question of questions) {\n for (const engine of engines) {\n if (engine === 'bing_ai_mode' && bingPromptLength(question) > BING_PROMPT_LIMIT) {\n rows.push({\n question,\n engine,\n result: 'unavailable',\n ...blank,\n error: `Bing AI Mode takes up to ${BING_PROMPT_LIMIT} characters after URL encoding.`,\n })\n continue\n }\n asks.push({ question, engine })\n }\n }\n const queued = asks.length\n ? await queue(\n input,\n runtime,\n 'ai-answers:queue',\n asks.map(({ question, engine }) => ({\n taskType: ENGINES[engine].type,\n idempotencyKey: answerKey(engine, code, day, question),\n payload: { prompt: question, country: code },\n })),\n )\n : []\n queued.forEach((entry, index) => {\n const ask = asks[index]\n if (!ask) return\n if ('id' in entry) {\n ids.push(entry.id)\n asked.set(entry.id, ask)\n } else rows.push({ ...ask, result: 'unavailable', ...blank, error: entry.error })\n })\n wait = waitSeconds(params.waitSeconds, 45)\n }\n if (wait && ids.length) await sleep(wait * 1_000)\n for (const task of await readTasks(input, runtime, 'ai-answers:read', ids)) {\n if (task.state === 'pending') {\n rows.push({\n question: questionOf(task.key) ?? asked.get(task.id)?.question ?? null,\n engine: engineOf(task.type) ?? asked.get(task.id)?.engine ?? null,\n result: 'pending',\n ...blank,\n task: task.id,\n })\n } else if (task.state === 'failed') {\n rows.push({\n question: questionOf(task.key),\n engine: engineOf(task.type),\n result: 'unavailable',\n ...blank,\n task: task.id,\n error: task.error,\n })\n } else {\n rows.push({\n question: questionOf(task.key),\n engine: engineOf(task.type),\n ...blank,\n ...classify(task.response, site),\n answeredAt: task.createdAt?.slice(0, 10) ?? null,\n credits: task.credits,\n task: task.id,\n })\n }\n }\n return {\n domain,\n rows,\n credits: rows.reduce((total, row) => total + row.credits, 0),\n pendingTasks: rows.flatMap((row) =>\n row.result === 'pending' && row.task ? [row.task] : [],\n ),\n }\n}\n\n// --- Schemas -----------------------------------------------------------------\n\nconst nullable = (type: string) => ({ type: [type, 'null'] })\nconst strings = (maxItems: number, description: string) => ({\n type: 'array',\n items: { type: 'string', minLength: 1, maxLength: 2_000 },\n minItems: 1,\n maxItems,\n description,\n})\nconst commonParams = {\n country: {\n type: 'string',\n pattern: '^[A-Za-z]{2}$',\n description: 'Two-letter country code. Default US.',\n },\n waitSeconds: {\n type: 'integer',\n minimum: 0,\n maximum: 120,\n description: 'Seconds to wait for queued tasks before reading them.',\n },\n}\n\nconst serp: SeoProviderActionAdapter = {\n id: 'serp',\n description:\n 'Google organic results and the pages the AI Overview cites, for up to 5 keywords. Results not ready come back as pendingTasks: run again with tasks to read them.',\n inputSchema: {\n type: 'object',\n properties: {\n keywords: strings(MAX_KEYWORDS, 'Keywords to search, 1 to 5.'),\n tasks: strings(50, 'Task ids from pendingTasks, to read instead of searching.'),\n ...commonParams,\n },\n additionalProperties: false,\n },\n outputSchema: {\n type: 'object',\n properties: {\n rows: {\n type: 'array',\n items: {\n type: 'object',\n properties: {\n keyword: nullable('string'),\n type: { type: 'string', enum: ['organic', 'ai_overview'] },\n position: nullable('number'),\n url: nullable('string'),\n domain: nullable('string'),\n title: nullable('string'),\n },\n required: ['keyword', 'type', 'position', 'url', 'domain', 'title'],\n },\n },\n credits: { type: 'number' },\n pendingTasks: { type: 'array', items: { type: 'string' } },\n errors: {\n type: 'array',\n items: {\n type: 'object',\n properties: {\n keyword: nullable('string'),\n task: nullable('string'),\n error: { type: 'string' },\n },\n required: ['keyword', 'task', 'error'],\n },\n },\n },\n required: ['rows', 'credits', 'pendingTasks', 'errors'],\n },\n run: serpAction,\n}\n\nconst aiAnswers: SeoProviderActionAdapter = {\n id: 'ai-answers',\n description:\n 'Ask ChatGPT, Google AI Mode, Gemini and Bing AI Mode up to 5 questions and report if each answer cites the site, mentions it, or neither. Answers not ready come back as pendingTasks.',\n inputSchema: {\n type: 'object',\n properties: {\n domain: {\n type: 'string',\n minLength: 3,\n maxLength: 253,\n description: 'The site to look for, such as example.com.',\n },\n questions: strings(MAX_QUESTIONS, 'Questions to ask, 1 to 5.'),\n engines: {\n type: 'array',\n items: { type: 'string', enum: ENGINE_NAMES },\n minItems: 1,\n maxItems: ENGINE_NAMES.length,\n description: 'Engines to ask. Default all four.',\n },\n brand: strings(\n 5,\n 'Names that count as a mention. Default the first label of the domain.',\n ),\n tasks: strings(100, 'Task ids from pendingTasks, to read instead of asking.'),\n ...commonParams,\n },\n required: ['domain'],\n additionalProperties: false,\n },\n outputSchema: {\n type: 'object',\n properties: {\n domain: { type: 'string' },\n rows: {\n type: 'array',\n items: {\n type: 'object',\n properties: {\n question: nullable('string'),\n engine: nullable('string'),\n result: {\n type: 'string',\n enum: ['cited', 'mentioned', 'neither', 'no_answer', 'pending', 'unavailable'],\n },\n citedUrl: nullable('string'),\n sources: { type: 'array', items: { type: 'string' } },\n model: nullable('string'),\n answeredAt: nullable('string'),\n credits: { type: 'number' },\n task: nullable('string'),\n error: nullable('string'),\n },\n required: [\n 'question',\n 'engine',\n 'result',\n 'citedUrl',\n 'sources',\n 'model',\n 'answeredAt',\n 'credits',\n 'task',\n 'error',\n ],\n },\n },\n credits: { type: 'number' },\n pendingTasks: { type: 'array', items: { type: 'string' } },\n },\n required: ['domain', 'rows', 'credits', 'pendingTasks'],\n },\n run: aiAnswersAction,\n}\n\n// --- Registration -----------------------------------------------------------\n\nconst activate: SeoProviderActivate = (host) => {\n host.registerProvider({\n id: 'cloro',\n displayName: 'cloro',\n description:\n 'Live Google results, AI Overview sources and answers from ChatGPT, Google AI Mode, Gemini and Bing AI Mode, from cloro.',\n kinds: ['search-results', 'ai-data'],\n connection: {\n fields: [\n {\n id: 'apiKey',\n label: 'API key',\n kind: 'secret',\n required: true,\n envVar: 'SEO_CLORO_API_KEY',\n },\n ],\n verify,\n verificationNotice:\n 'The connection check reads the credit balance. It costs no credits.',\n },\n capabilities: [\n {\n id: 'serp-snapshot',\n defaultDepth: 10,\n maxDepth: MAX_DEPTH,\n maxRequests: SNAPSHOT_REQUESTS,\n markets: [\n {\n searchEngines: ['google'],\n devices: ['desktop', 'mobile'],\n location: 'country-only',\n },\n ],\n estimateCostMicros: ({ depth }) =>\n snapshotCredits(pagesFor(depth)) * MICROS_PER_CREDIT,\n // One to queue and, at most, the rest to read.\n estimateRequests: () => SNAPSHOT_REQUESTS,\n run: serpSnapshot,\n },\n ],\n actions: [serp, aiAnswers],\n })\n}\n\nexport default activate\n"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,70 @@
 {
   "name": "@cloro-dev/seo-provider",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "cloro provider for the seo package: live Google results, AI Overview sources and AI answers from ChatGPT, Google AI Mode, Gemini and Bing AI Mode.",
+  "author": "cloro",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/cloro-dev/seo-provider#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloro-dev/seo-provider.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cloro-dev/seo-provider/issues"
+  },
+  "keywords": [
+    "seo",
+    "cloro",
+    "serp",
+    "ai-overview",
+    "chatgpt",
+    "gemini",
+    "ai-mode",
+    "provider"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/index.d.ts",
+    "dist/index.js",
+    "dist/index.js.map"
+  ],
+  "seo": {
+    "apiVersion": 1,
+    "providers": [
+      "./dist/index.js"
+    ]
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "scripts": {
+    "build": "tsdown --config tsdown.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test dist/index.test.js",
+    "package:check": "node scripts/package.test.mjs",
+    "prepack": "npm run build && npm test && npm run package:check"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "seo": "^0.17.3",
+    "tsdown": "^0.23.7",
+    "typescript": "^6.0.3",
+    "zod": "^4.6.7"
+  },
+  "peerDependencies": {
+    "seo": ">=0.17.3"
+  }
+}