Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
// Constants and target builders shared between server code (features,
// workflows, MCP tools) and the section fetchers. Keep this module free of
// section-file imports so both sides can import it without cycles.
// ChatGPT mention/response data is only available for US/en per DataForSEO docs.
export const CHATGPT_LOCATION_CODE = 2840;
export const CHATGPT_LANGUAGE_CODE = "en";
export type LlmPlatform = "chat_gpt" | "google";
export { MAX_TASKS_PER_POST } from "@/shared/rank-tracking";
// DataForSEO's LLM-mentions `target` array accepts domain OR keyword entries.
// We always pass exactly one target per call.
export type LlmTarget =
| {
domain: string;
include_subdomains?: boolean;
search_filter?: "include" | "exclude";
search_scope?: string[];
}
| {
keyword: string;
search_filter?: "include" | "exclude";
search_scope?: string[];
match_type?: "word_match" | "partial_match";
};
export function buildLlmTarget(input: {
type: "domain" | "keyword";
value: string;
/**
* Domain targets only. Defaults to the historical behavior (subdomains
* included); research scopes narrower than `subdomains` pass `false`. There
* is no URL/path-level targeting in this API — page-level scoping happens by
* post-filtering the returned page URLs.
*/
includeSubdomains?: boolean;
}): LlmTarget {
if (input.type === "domain") {
return {
domain: input.value,
include_subdomains: input.includeSubdomains ?? true,
search_filter: "include",
search_scope: ["any"],
};
}
return {
keyword: input.value,
search_filter: "include",
search_scope: ["any", "brand_entities"],
match_type: "word_match",
};
}