@agentsean/providers 1.0.0

package/dist/autocomplete.js

@@ -0,0 +1,40 @@
+import { freeEstimate } from "./rates.js";
+/**
+ * Public suggest endpoints. Expansion, not rank checking.
+ * Not Google HTML SERP scraping (T4).
+ */
+export async function autocomplete(seed, opts) {
+    const fetchFn = opts?.fetch ?? fetch;
+    const kind = opts?.endpoint ?? "google";
+    if (kind === "duckduckgo") {
+        const url = `https://duckduckgo.com/ac/?q=${encodeURIComponent(seed)}`;
+        const res = await fetchFn(url, { headers: { accept: "application/json" } });
+        if (!res.ok)
+            throw new Error(`autocomplete HTTP ${res.status}`);
+        const json = (await res.json());
+        const rows = Array.isArray(json) ? json : [];
+        return rows
+            .map((row) => {
+            const rec = row && typeof row === "object" ? row : null;
+            return rec?.phrase?.trim() ?? "";
+        })
+            .filter(Boolean)
+            .map((query) => ({ query, source: "autocomplete", relatedTo: seed }));
+    }
+    const url = `https://suggestqueries.google.com/complete/search?client=firefox&q=${encodeURIComponent(seed)}`;
+    const res = await fetchFn(url, { headers: { accept: "application/json" } });
+    if (!res.ok)
+        throw new Error(`autocomplete HTTP ${res.status}`);
+    const json = (await res.json());
+    const suggestions = Array.isArray(json) && Array.isArray(json[1]) ? json[1] : [];
+    return suggestions
+        .filter((s) => typeof s === "string" && s.trim().length > 0)
+        .map((query) => ({ query, source: "autocomplete", relatedTo: seed }));
+}
+export function autocompleteCall(seed, opts) {
+    return {
+        estimate: freeEstimate("autocomplete", "keywords", "suggest", 1, "public suggest endpoint"),
+        run: () => autocomplete(seed, opts),
+    };
+}
+//# sourceMappingURL=autocomplete.js.map

package/dist/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../src/autocomplete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,IAAmE;IAEnE,MAAM,OAAO,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,EAAE,QAAQ,IAAI,QAAQ,CAAC;IACxC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,gCAAgC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;QAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,MAAM,GAAG,GACP,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA2B,CAAC,CAAC,CAAC,IAAI,CAAC;YACvE,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC,CAAC;aACD,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,GAAG,GAAG,sEAAsE,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7G,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC5E,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;IAC3C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,WAAW;SACf,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACxE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,IAAmE;IAEnE,OAAO;QACL,QAAQ,EAAE,YAAY,CACpB,cAAc,EACd,UAAU,EACV,SAAS,EACT,CAAC,EACD,yBAAyB,CAC1B;QACD,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/bing.d.ts

@@ -0,0 +1,23 @@
+import type { KeywordRow, VolumeCapability, VolumeRow } from "./types.js";
+export type BingClient = {
+    getKeywordStats(query: string, opts?: {
+        country?: string;
+        language?: string;
+    }): Promise<VolumeRow>;
+    getRelatedKeywords(query: string, opts?: {
+        country?: string;
+        language?: string;
+    }): Promise<KeywordRow[]>;
+};
+/**
+ * Bing Webmaster GetKeywordStats / GetRelatedKeywords — the best free demand proxy.
+ * Requires a Webmaster API key the user owns. Not the decommissioned Bing Search API.
+ */
+export declare function createBingClient(opts: {
+    apiKey: string;
+    fetch?: typeof fetch;
+    baseUrl?: string;
+}): BingClient;
+export declare function createBingVolume(client: BingClient): VolumeCapability;
+export declare function bingRelated(client: BingClient, seed: string): Promise<KeywordRow[]>;
+//# sourceMappingURL=bing.d.ts.map

package/dist/bing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bing.d.ts","sourceRoot":"","sources":["../src/bing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAgB,MAAM,YAAY,CAAC;AAKxF,MAAM,MAAM,UAAU,GAAG;IACvB,eAAe,CACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,SAAS,CAAC,CAAC;IACtB,kBAAkB,CAChB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,UAAU,CAyCb;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAsBrE;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,EAAE,CAAC,CAEvB"}

package/dist/bing.js

@@ -0,0 +1,128 @@
+import { freeEstimate } from "./rates.js";
+const BING_JSON = "https://ssl.bing.com/webmaster/api.svc/json";
+/**
+ * Bing Webmaster GetKeywordStats / GetRelatedKeywords — the best free demand proxy.
+ * Requires a Webmaster API key the user owns. Not the decommissioned Bing Search API.
+ */
+export function createBingClient(opts) {
+    const fetchFn = opts.fetch ?? fetch;
+    const base = opts.baseUrl ?? BING_JSON;
+    async function getJson(path, params) {
+        const url = new URL(`${base}/${path}`);
+        url.searchParams.set("apikey", opts.apiKey);
+        for (const [k, v] of Object.entries(params))
+            url.searchParams.set(k, v);
+        const res = await fetchFn(url, { headers: { accept: "application/json" } });
+        if (!res.ok) {
+            throw new Error(`Bing Webmaster HTTP ${res.status} on ${path}`);
+        }
+        return res.json();
+    }
+    return {
+        async getKeywordStats(query, extra) {
+            const json = await getJson("GetKeywordStats", {
+                q: query,
+                country: extra?.country ?? "us",
+                language: extra?.language ?? "en-US",
+            });
+            return {
+                query,
+                volume: parseVolume(json, query),
+                source: "bing",
+                country: extra?.country ?? "us",
+            };
+        },
+        async getRelatedKeywords(query, extra) {
+            const json = await getJson("GetRelatedKeywords", {
+                q: query,
+                country: extra?.country ?? "us",
+                language: extra?.language ?? "en-US",
+            });
+            return parseRelated(json, query);
+        },
+    };
+}
+export function createBingVolume(client) {
+    return {
+        id: "bing",
+        volume(queries, extra) {
+            return {
+                estimate: freeEstimate("bing", "volume", "GetKeywordStats", queries.length, "Bing Webmaster"),
+                async run() {
+                    const out = [];
+                    for (const q of queries) {
+                        out.push(await client.getKeywordStats(q, extra));
+                    }
+                    return out;
+                },
+            };
+        },
+    };
+}
+export async function bingRelated(client, seed) {
+    return client.getRelatedKeywords(seed);
+}
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : null;
+}
+function rowsOf(json) {
+    const rec = asRecord(json);
+    if (!rec)
+        return [];
+    if (Array.isArray(rec["d"]))
+        return rec["d"];
+    const d = asRecord(rec["d"]);
+    if (d && Array.isArray(d["results"]))
+        return d["results"];
+    if (Array.isArray(rec["results"]))
+        return rec["results"];
+    return [];
+}
+function num(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return v;
+    if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)))
+        return Number(v);
+    return null;
+}
+function parseVolume(json, fallback) {
+    const rec = asRecord(json);
+    if (rec) {
+        const direct = num(rec["Count"] ?? rec["count"] ?? rec["Impressions"] ?? rec["volume"]);
+        if (direct !== null)
+            return Math.round(direct);
+    }
+    for (const row of rowsOf(json)) {
+        const r = asRecord(row);
+        if (!r)
+            continue;
+        const q = String(r["Query"] ?? r["query"] ?? fallback);
+        if (q.toLowerCase() !== fallback.toLowerCase() && rowsOf(json).length > 1)
+            continue;
+        const v = num(r["Count"] ?? r["count"] ?? r["Impressions"] ?? r["volume"]);
+        if (v !== null)
+            return Math.round(v);
+    }
+    return null;
+}
+function parseRelated(json, seed) {
+    const out = [];
+    for (const row of rowsOf(json)) {
+        const r = asRecord(row);
+        if (!r)
+            continue;
+        const query = String(r["Query"] ?? r["query"] ?? r["Keyword"] ?? "").trim();
+        if (!query)
+            continue;
+        out.push({
+            query,
+            source: "bing",
+            relatedTo: seed,
+            volume: num(r["Count"] ?? r["count"] ?? r["volume"]),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=bing.js.map

package/dist/bing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bing.js","sourceRoot":"","sources":["../src/bing.ts"],"names":[],"mappings":"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"}

package/dist/dataforseo.d.ts

@@ -0,0 +1,33 @@
+import type { BacklinkOverview, BacklinksCapability, KeywordRow, ProviderCall, SerpCapability, SerpResult, VolumeCapability, VolumeRow } from "./types.js";
+export type DataForSeoClient = {
+    searchVolume: (queries: string[], locationCode?: number) => Promise<{
+        rows: VolumeRow[];
+        actualUsd: number;
+    }>;
+    related: (seed: string) => Promise<{
+        rows: KeywordRow[];
+        actualUsd: number;
+    }>;
+    serp: (query: string, locationCode?: number) => Promise<{
+        result: SerpResult;
+        actualUsd: number;
+    }>;
+    backlinks: (target: string) => Promise<{
+        overview: BacklinkOverview;
+        actualUsd: number;
+    }>;
+};
+/**
+ * DataForSEO HTTP client. ADAPT of OpenSEO endpoint coverage + cost-before-call.
+ * Auth is HTTP Basic (login:password). The LLM never sees this secret.
+ */
+export declare function createDataForSeoClient(opts: {
+    loginPassword: string;
+    fetch?: typeof fetch;
+    baseUrl?: string;
+}): DataForSeoClient;
+export declare function createDataForSeoVolume(client: DataForSeoClient): VolumeCapability;
+export declare function createDataForSeoSerp(client: DataForSeoClient): SerpCapability;
+export declare function createDataForSeoBacklinks(client: DataForSeoClient): BacklinksCapability;
+export declare function dataforseoRelatedCall(client: DataForSeoClient, seed: string): ProviderCall<KeywordRow[]>;
+//# sourceMappingURL=dataforseo.d.ts.map

package/dist/dataforseo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataforseo.d.ts","sourceRoot":"","sources":["../src/dataforseo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,cAAc,EAEd,UAAU,EACV,gBAAgB,EAChB,SAAS,EACV,MAAM,YAAY,CAAC;AAKpB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,EAAE,CACZ,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,CAAC,EAAE,MAAM,KAClB,OAAO,CAAC;QAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,IAAI,EAAE,CACJ,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,KAClB,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,SAAS,EAAE,CACT,MAAM,EAAE,MAAM,KACX,OAAO,CAAC;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,gBAAgB,CA2InB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAqBjF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAqB7E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,GACvB,mBAAmB,CAqBrB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GACX,YAAY,CAAC,UAAU,EAAE,CAAC,CAc5B"}

package/dist/dataforseo.js

@@ -0,0 +1,267 @@
+import { DFS_RATES, keywordsDataTasks, paidEstimate } from "./rates.js";
+const DFS_BASE = "https://api.dataforseo.com";
+/**
+ * DataForSEO HTTP client. ADAPT of OpenSEO endpoint coverage + cost-before-call.
+ * Auth is HTTP Basic (login:password). The LLM never sees this secret.
+ */
+export function createDataForSeoClient(opts) {
+    const fetchFn = opts.fetch ?? fetch;
+    const base = opts.baseUrl ?? DFS_BASE;
+    const auth = `Basic ${Buffer.from(opts.loginPassword).toString("base64")}`;
+    async function post(path, body) {
+        const res = await fetchFn(`${base}${path}`, {
+            method: "POST",
+            headers: {
+                authorization: auth,
+                "content-type": "application/json",
+                accept: "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`DataForSEO HTTP ${res.status} on ${path}`);
+        return (await res.json());
+    }
+    async function get(path) {
+        const res = await fetchFn(`${base}${path}`, {
+            method: "GET",
+            headers: { authorization: auth, accept: "application/json" },
+        });
+        if (!res.ok)
+            throw new Error(`DataForSEO HTTP ${res.status} on ${path}`);
+        return (await res.json());
+    }
+    return {
+        async searchVolume(queries, locationCode = 2840) {
+            const env = await post("/v3/keywords_data/google_ads/search_volume/live", [
+                { keywords: queries, location_code: locationCode, language_code: "en" },
+            ]);
+            const rows = [];
+            for (const item of taskItems(env)) {
+                const rec = asRecord(item);
+                if (!rec)
+                    continue;
+                const q = String(rec["keyword"] ?? rec["search_query"] ?? "");
+                if (!q)
+                    continue;
+                rows.push({
+                    query: q,
+                    volume: num(rec["search_volume"]),
+                    source: "dataforseo",
+                });
+            }
+            return { rows, actualUsd: env.cost ?? 0 };
+        },
+        async related(seed) {
+            const env = await post("/v3/keywords_data/google_ads/keywords_for_keywords/live", [{ keywords: [seed], location_code: 2840, language_code: "en" }]);
+            const rows = [];
+            for (const item of taskItems(env)) {
+                const rec = asRecord(item);
+                if (!rec)
+                    continue;
+                const q = String(rec["keyword"] ?? "");
+                if (!q)
+                    continue;
+                rows.push({
+                    query: q,
+                    source: "dataforseo",
+                    relatedTo: seed,
+                    volume: num(rec["search_volume"]),
+                });
+            }
+            return { rows, actualUsd: env.cost ?? 0 };
+        },
+        async serp(query, locationCode = 2840) {
+            const posted = await post("/v3/serp/google/organic/task_post", [
+                { keyword: query, location_code: locationCode, language_code: "en" },
+            ]);
+            const taskId = posted.tasks?.[0]?.id;
+            let env = posted;
+            if (taskId && !taskReady(posted)) {
+                env = await get(`/v3/serp/google/organic/task_get/regular/${taskId}`);
+            }
+            const items = [];
+            const paa = [];
+            const related = [];
+            for (const item of serpItems(env)) {
+                const rec = asRecord(item);
+                if (!rec)
+                    continue;
+                const type = String(rec["type"] ?? "");
+                if (type === "organic" || rec["url"]) {
+                    const url = String(rec["url"] ?? "");
+                    if (!url)
+                        continue;
+                    items.push({
+                        rank: num(rec["rank_group"] ?? rec["rank_absolute"]) ?? items.length + 1,
+                        url,
+                        title: String(rec["title"] ?? ""),
+                        ...(typeof rec["description"] === "string"
+                            ? { snippet: rec["description"] }
+                            : {}),
+                    });
+                }
+                if (type === "people_also_ask" && Array.isArray(rec["items"])) {
+                    for (const q of rec["items"]) {
+                        const r = asRecord(q);
+                        const title = r && typeof r["title"] === "string" ? r["title"] : "";
+                        if (title)
+                            paa.push(title);
+                    }
+                }
+                if (type === "related_searches" && Array.isArray(rec["items"])) {
+                    for (const q of rec["items"]) {
+                        const r = asRecord(q);
+                        const title = r && typeof r["title"] === "string" ? r["title"] : "";
+                        if (title)
+                            related.push(title);
+                    }
+                }
+            }
+            return {
+                result: {
+                    query,
+                    provider: "dataforseo",
+                    items: items.toSorted((a, b) => a.rank - b.rank).slice(0, 10),
+                    ...(paa.length ? { paa } : {}),
+                    ...(related.length ? { related } : {}),
+                },
+                actualUsd: env.cost ?? posted.cost ?? 0,
+            };
+        },
+        async backlinks(target) {
+            const env = await post("/v3/backlinks/summary/live", [
+                { target, include_subdomains: true },
+            ]);
+            const rec = asRecord(taskItems(env)[0]) ?? {};
+            return {
+                overview: {
+                    target,
+                    provider: "dataforseo",
+                    kind: "backlinks",
+                    referringDomains: num(rec["referring_domains"]),
+                    backlinks: num(rec["backlinks"]),
+                    rank: num(rec["rank"]),
+                },
+                actualUsd: env.cost ?? 0,
+            };
+        },
+    };
+}
+export function createDataForSeoVolume(client) {
+    return {
+        id: "dataforseo",
+        volume(queries) {
+            const tasks = keywordsDataTasks(queries.length);
+            return {
+                estimate: paidEstimate({
+                    provider: "dataforseo",
+                    capability: "volume",
+                    operation: "search_volume",
+                    units: tasks,
+                    unitUsd: DFS_RATES.keywordsDataPerTask,
+                    notes: `Keywords Data $0.06/task · ${queries.length} keywords`,
+                }),
+                async run() {
+                    const { rows } = await client.searchVolume(queries);
+                    return rows;
+                },
+            };
+        },
+    };
+}
+export function createDataForSeoSerp(client) {
+    return {
+        id: "dataforseo",
+        available: true,
+        serp(query) {
+            return {
+                estimate: paidEstimate({
+                    provider: "dataforseo",
+                    capability: "serp",
+                    operation: "organic_standard",
+                    units: 1,
+                    unitUsd: DFS_RATES.serpPerKeyword,
+                    notes: "SERP $0.60/1k standard queue",
+                }),
+                async run() {
+                    const { result } = await client.serp(query);
+                    return result;
+                },
+            };
+        },
+    };
+}
+export function createDataForSeoBacklinks(client) {
+    return {
+        id: "dataforseo",
+        available: true,
+        overview(target) {
+            return {
+                estimate: paidEstimate({
+                    provider: "dataforseo",
+                    capability: "backlinks",
+                    operation: "summary",
+                    units: 1,
+                    unitUsd: DFS_RATES.backlinksPerRequest,
+                    notes: "Backlinks $0.024/req + $0.000036/row",
+                }),
+                async run() {
+                    const { overview } = await client.backlinks(target);
+                    return overview;
+                },
+            };
+        },
+    };
+}
+export function dataforseoRelatedCall(client, seed) {
+    return {
+        estimate: paidEstimate({
+            provider: "dataforseo",
+            capability: "keywords",
+            operation: "keywords_for_keywords",
+            units: 1,
+            unitUsd: DFS_RATES.keywordsDataPerTask,
+        }),
+        async run() {
+            const { rows } = await client.related(seed);
+            return rows;
+        },
+    };
+}
+function taskReady(env) {
+    const code = env.tasks?.[0]?.status_code;
+    return code === 20000;
+}
+function taskItems(env) {
+    const result = env.tasks?.[0]?.result;
+    if (!Array.isArray(result) || result.length === 0)
+        return [];
+    const first = result[0];
+    const rec = asRecord(first);
+    if (rec && Array.isArray(rec["items"]))
+        return rec["items"];
+    return result;
+}
+function serpItems(env) {
+    const result = env.tasks?.[0]?.result;
+    if (!Array.isArray(result) || result.length === 0)
+        return [];
+    const first = asRecord(result[0]);
+    if (first && Array.isArray(first["items"]))
+        return first["items"];
+    return [];
+}
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : null;
+}
+function num(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return v;
+    if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)))
+        return Number(v);
+    return null;
+}
+//# sourceMappingURL=dataforseo.js.map

package/dist/dataforseo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataforseo.js","sourceRoot":"","sources":["../src/dataforseo.ts"],"names":[],"mappings":"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"}

package/dist/gsc.d.ts

@@ -0,0 +1,4 @@
+import type { KeywordRow, KeywordsCapability } from "./types.js";
+/** Query demand from GSC Search Analytics. 25k rows, 1,200 QPM/site. $0. */
+export declare function createGscKeywords(rows: KeywordRow[]): KeywordsCapability;
+//# sourceMappingURL=gsc.d.ts.map

package/dist/gsc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsc.d.ts","sourceRoot":"","sources":["../src/gsc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAgB,MAAM,YAAY,CAAC;AAG/E,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAiCxE"}

package/dist/gsc.js

@@ -0,0 +1,26 @@
+import { freeEstimate } from "./rates.js";
+/** Query demand from GSC Search Analytics. 25k rows, 1,200 QPM/site. $0. */
+export function createGscKeywords(rows) {
+    return {
+        id: "gsc",
+        demand() {
+            return {
+                estimate: freeEstimate("gsc", "keywords", "search_analytics", rows.length, "GSC query demand"),
+                async run() {
+                    return rows.map((r) => ({ ...r, source: r.source || "gsc" }));
+                },
+            };
+        },
+        related(seed) {
+            const needle = seed.toLowerCase();
+            const hits = rows.filter((r) => r.query.toLowerCase().includes(needle) && r.query.toLowerCase() !== needle);
+            return {
+                estimate: freeEstimate("gsc", "keywords", "related_from_demand", hits.length),
+                async run() {
+                    return hits.map((r) => Object.assign({}, r, { source: "gsc", relatedTo: seed }));
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=gsc.js.map

package/dist/gsc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsc.js","sourceRoot":"","sources":["../src/gsc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,IAAkB;IAClD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM;YACJ,OAAO;gBACL,QAAQ,EAAE,YAAY,CACpB,KAAK,EACL,UAAU,EACV,kBAAkB,EAClB,IAAI,CAAC,MAAM,EACX,kBAAkB,CACnB;gBACD,KAAK,CAAC,GAAG;oBACP,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;gBAChE,CAAC;aACF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAY;YAClB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CACtB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAC7E,CAAC;YACF,OAAO;gBACL,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,IAAI,CAAC,MAAM,CAAC;gBAC7E,KAAK,CAAC,GAAG;oBACP,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CACzD,CAAC;gBACJ,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { Capability, CostEstimate, ProviderCall, KeywordRow, VolumeRow, SerpItem, SerpResult, BacklinkOverview, KeywordsCapability, VolumeCapability, SerpCapability, BacklinksCapability, ExtractPage, EntityHit, WaybackCapture, ProviderKeys, ProviderStack, } from "./types.js";
+export { CAPABILITIES } from "./types.js";
+export { DFS_RATES, FREE_NOTE, freeEstimate, paidEstimate, roundUsd, keywordsDataTasks, } from "./rates.js";
+export { DEAD_PROVIDERS, ProviderRefusedError, isDeadProvider, refuseDeadProvider, scrapeGoogleSerp, } from "./refuse.js";
+export { recordQuote, debitProvider, spendTodayUsd, remainingBudgetUsd, } from "./ledger.js";
+export { createGscKeywords } from "./gsc.js";
+export { createBingClient, createBingVolume, bingRelated } from "./bing.js";
+export { autocomplete, autocompleteCall } from "./autocomplete.js";
+export { createOpenPageRank, fetchOpenPageRank } from "./openpagerank.js";
+export { waybackCdx } from "./wayback.js";
+export { jinaRead } from "./jina.js";
+export { wikidataSearch } from "./wikidata.js";
+export { createDataForSeoClient, createDataForSeoVolume, createDataForSeoSerp, createDataForSeoBacklinks, dataforseoRelatedCall, } from "./dataforseo.js";
+export { createProviderStack, loadProviderKeys, PROVIDER_ACCOUNTS, } from "./registry.js";
+export { unavailableSerp, unavailableVolume, unavailableBacklinks, } from "./unavailable.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { CAPABILITIES } from "./types.js";
+export { DFS_RATES, FREE_NOTE, freeEstimate, paidEstimate, roundUsd, keywordsDataTasks, } from "./rates.js";
+export { DEAD_PROVIDERS, ProviderRefusedError, isDeadProvider, refuseDeadProvider, scrapeGoogleSerp, } from "./refuse.js";
+export { recordQuote, debitProvider, spendTodayUsd, remainingBudgetUsd, } from "./ledger.js";
+export { createGscKeywords } from "./gsc.js";
+export { createBingClient, createBingVolume, bingRelated } from "./bing.js";
+export { autocomplete, autocompleteCall } from "./autocomplete.js";
+export { createOpenPageRank, fetchOpenPageRank } from "./openpagerank.js";
+export { waybackCdx } from "./wayback.js";
+export { jinaRead } from "./jina.js";
+export { wikidataSearch } from "./wikidata.js";
+export { createDataForSeoClient, createDataForSeoVolume, createDataForSeoSerp, createDataForSeoBacklinks, dataforseoRelatedCall, } from "./dataforseo.js";
+export { createProviderStack, loadProviderKeys, PROVIDER_ACCOUNTS, } from "./registry.js";
+export { unavailableSerp, unavailableVolume, unavailableBacklinks, } from "./unavailable.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/jina.d.ts

@@ -0,0 +1,6 @@
+import type { ExtractPage } from "./types.js";
+/** Jina Reader keyless, 20 RPM. */
+export declare function jinaRead(url: string, opts?: {
+    fetch?: typeof fetch;
+}): Promise<ExtractPage>;
+//# sourceMappingURL=jina.d.ts.map

package/dist/jina.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jina.d.ts","sourceRoot":"","sources":["../src/jina.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,mCAAmC;AACnC,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAC9B,OAAO,CAAC,WAAW,CAAC,CActB"}