Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
/**
* OpenSEO on an Every App gateway (AUTH_MODE=everyapp). The gateway signs
* people in and decides who may open OpenSEO, serves its MCP tools on the
* gateway's one connector, and holds the DataForSEO, Context and OpenRouter
* keys, so a deploy needs no OpenSEO settings to open (its own two,
* CRAWLER_ACCESS_SECRET and OPENROUTER_MODEL, are optional, below). See
* docs/maintainers/every-app.md.
*
* D1 and KV, one organization (EVERY_APP_ORG_ID, set by the deploy).
*
* pnpm dev:everyapp # local, behind a gateway-lite with a dev user
* pnpm everyapp install https://github.com/every-app/open-seo
* # onto your Gateway, from an Every App checkout
*/
export default {
id: "openseo",
name: "OpenSEO",
description: "SEO research you pay for by use, not by the month.",
icon: "/everyapp-icon.svg",
// wrangler.jsonc's, so every build of OpenSEO runs on the same runtime.
compatibilityDate: "2025-09-02",
resources: {
d1: ["DB"],
kv: ["KV"],
durableObjects: [
{ name: "SAM_CHAT", className: "SamChatAgent" },
// Each audit's crawl state, private to the audit Worker.
{
name: "AUDIT_SCRATCHPAD",
className: "AuditScratchpad",
worker: "audit",
},
],
workflows: [
{ name: "RANK_CHECK_WORKFLOW", className: "RankCheckWorkflow" },
{ name: "AI_VISIBILITY_WORKFLOW", className: "AiVisibilityWorkflow" },
{ name: "LOCAL_RANK_WORKFLOW", className: "LocalRankWorkflow" },
{
name: "SITE_AUDIT_WORKFLOW",
className: "SiteAuditWorkflow",
worker: "audit",
},
],
},
// The site-audit engine (src/audit-worker.ts), on an isolate of its own
// as the open-seo-audit Worker elsewhere. The app reaches it through
// AUDIT_ENGINE and SITE_AUDIT_WORKFLOW.
workers: [{ name: "audit", binding: "AUDIT_ENGINE" }],
// `config` names the drizzle config the deploy's schema check runs
// drizzle-kit generate with; there is no drizzle.config.ts at the root
// (the Postgres and remote-D1 configs sit beside this one).
migrations: {
engine: "drizzle",
dir: "drizzle/sqlite",
config: "drizzle/sqlite.config.ts",
binding: "DB",
},
// What the gateway must hold before OpenSEO opens (required, the default)
// or may hold (optional: the feature says what is missing where it is
// used). `why` is for whoever sets it.
// Through the gateway's AI proxy and its OPENROUTER_API_KEY.
providers: [
{
id: "openrouter",
why: "SAM, prompt suggestions and website research run on it.",
},
],
// What OpenSEO calls through the gateway with keys only the gateway holds
// (integrationFetch). An approval covers the app; every call counts
// against the install's organization (src/server/lib/gateway-attribution.ts).
capabilities: {
dataforseo: {
access: "read",
why: "Keyword, SERP, backlink, local business and AI answer data, including scheduled rank checks. The value is `login:password` from the DataForSEO dashboard, or its base64.",
},
// Audits run without it: the "Render JavaScript" option says an admin
// sets it (src/server/lib/audit/rendering-policy.ts).
context: {
access: "read",
optional: true,
why: "Renders JavaScript-heavy pages when a site audit asks for it.",
},
// The gateway holds the Google client and each member's connection
// (Every App → Settings → Connected accounts); Search Console and GA4
// reads go through it with the member's token (src/server/features/
// google/gatewayGoogle.ts). Without it the Google cards say so.
"google-workspace": {
// "read" is what OpenSEO needs (the three sets below are read-only and
// the gateway holds every call to them); the published CLI (0.3.0-rc.3)
// still lists the Google client as write-only, so "write" until rc.4.
access: "write",
optional: true,
scopes: ["identity", "search-console.read", "analytics.read"],
why: "Search Console and GA4 reads for your sites, with the Google account you connect in Every App.",
},
},
// OpenSEO's own, on its Workers (`pnpm everyapp secret set <NAME> --app
// openseo`). Without CRAWLER_ACCESS_SECRET the crawler-access form says so
// (src/client/features/crawler-access/CrawlerAccessForm.tsx); without
// OPENROUTER_MODEL the default in src/server/lib/openrouter.ts is used.
secrets: [
{
name: "CRAWLER_ACCESS_SECRET",
optional: true,
why: "Encrypts the Shopify crawler-access signatures that audits of protected stores send. Any string of 32+ characters, e.g. `openssl rand -base64 32`.",
},
{
name: "OPENROUTER_MODEL",
optional: true,
why: "Picks the OpenRouter model for SAM, prompt suggestions and website research (default openai/gpt-5.6-luna). The key itself is the gateway's OPENROUTER_API_KEY.",
},
],
// Both Workers, from cloudflare.config.ts and vite-plugin-every-app.ts.
build: "pnpm build:report-widgets && AUTH_MODE=everyapp pnpm exec vite build",
dev: "pnpm build:report-widgets && AUTH_MODE=everyapp pnpm exec vite dev --host 127.0.0.1",
// Nothing reaches OpenSEO without a signed-in member: report sharing and
// the other unauthenticated routes are hosted-only, and the gateway's tool
// calls (`/__everyapp/tools/*`) carry their own gateway-signed tokens.
// Every member opens OpenSEO once it is installed, like the other three
// launch apps (OpenCRM, OpenAnalytics, Agentic Inbox): the documented
// default for them. Without it a fresh install opens to owners and admins
// only, and an admin grants the rest by hand.
access: "everyone",
public: [],
} as const;