Every-App Related Projects: The OpenSEO Ecosystem Explained

Every-App maintains three complementary open-source projects that power OpenSEO: SAM (an LLM inference server for AI insights), the Every-App SDK (Cloudflare Workers and D1 database utilities), and the Skill-Repo (AI agent skills for keyword research and link prospecting).

The every-app/open-seo repository represents just one component of a broader ecosystem. Understanding the every-app related projects reveals how this self-hostable SEO platform integrates AI-driven insights, serverless infrastructure, and extensible agent capabilities.

Every-App Related Projects Overview

The OpenSEO README explicitly documents three related projects in the every-app organization that extend the platform's core functionality.

SAM (AI Inference Server)

SAM is every-app's large-language-model inference server. OpenSEO leverages SAM for AI-driven SEO insights and visibility scoring according to the source code documentation.

Repository: https://github.com/every-app/sam

Every-App SDK

The Every-App SDK provides helper libraries for Cloudflare Workers, D1 databases, and server-side utilities. OpenSEO imports @every-app/sdk to handle Cloudflare KV namespaces and D1 database connections, making it a critical dependency for the Cloudflare Workers deployment model.

Repository: https://github.com/every-app/sdk

Skill-Repo (AI Agent Skills)

The Every-App/skill-repo contains AI agent skills that integrate with OpenSEO, including capabilities for keyword research, link prospecting, and competitor analysis. These skills extend the platform beyond its core DataForSEO API integration.

Repository: https://github.com/every-app/skill-repo

Technical Integration Points

These related projects are not merely conceptual; they are hard dependencies within OpenSEO's architecture, with specific integration points visible in the source code.

SDK Integration in Server Configuration

In src/server.ts, OpenSEO imports core utilities from the Every-App SDK to configure its server infrastructure:

import { defineApp } from "@every-app/sdk/server"
import { createAppRouter } from "@every-app/sdk/router"
import { getLocalD1Url } from "@every-app/sdk/cloudflare/server"

export default defineConfig({
  plugins: [
    createApp({
      kvNamespace: "OPEN_SEO_KV",
      d1Database: "OPEN_SEO_DB",
      d1Url: getLocalD1Url(),
    }),
    createServerFn({
      router: createAppRouter({
        addRoutes,
      }),
    }),
  ],
})

The getLocalD1Url() function enables local development against Cloudflare's D1 SQLite-compatible database, while defineApp configures the KV namespace binding and D1 database parameters.

SAM Integration for AI Insights

OpenSEO calls the SAM service for AI-generated recommendations and visibility scoring. This integration processes search data through the LLM inference layer, providing the "AI-driven insights" feature listed in the platform's capabilities.

Google Search Console Utilities

OpenSEO provides GSC integration utilities in src/shared/gsc.ts, including the getGSCAuthUrl function for OAuth authentication:

export function getGSCAuthUrl(clientId: string, redirectUri: string) {
  const base = "https://accounts.google.com/o/oauth2/v2/auth"
  const params = new URLSearchParams({
    client_id: clientId,
    redirect_uri: redirectUri,
    response_type: "code",
    scope: "https://www.googleapis.com/auth/webmasters.readonly",
    access_type: "offline",
  })
  return `${base}?${params}`
}

This helper constructs the authorization URL required for Google Search Console data import, documented in docs/SELF_HOSTING_GOOGLE_SEARCH_CONSOLE.md.

Deployment Architecture Using Related Projects

OpenSEO supports two deployment models, with the Cloudflare Workers implementation directly leveraging the Every-App SDK's utilities.

Docker Deployment

For self-hosting with Docker:

git clone https://github.com/every-app/open-seo.git
cd open-seo
cp .env.example .env

# Edit .env to set DATAFORSEO_USERNAME and DATAFORSEO_PASSWORD

docker compose up --build

Access the application at http://localhost:3000.

Cloudflare Workers Deployment

Deploying to Cloudflare Workers utilizes the SDK's built-in optimizations and serverless bindings:

npm i -g @cloudflare/wrangler
wrangler deploy https://github.com/every-app/open-seo

This deployment method relies on the Every-App SDK's defineApp and getLocalD1Url functions to manage the Cloudflare KV namespace and D1 database connections.

Extending OpenSEO with Skill-Repo

The Skill-Repo project allows developers to extend OpenSEO's capabilities through AI agent skills.

Install skills using the CLI:

# Install basic OpenSEO skills

npx skills add every-app/open-seo

# Install all available skills

npx skills add every-app/open-seo --skill '*'

# Install with specific agent (e.g., Claude-code)

npx skills add every-app/open-seo --skill '*' --agent claude-code

These skills integrate with OpenSEO's AI layer, adding specialized capabilities like automated link prospecting and competitor analysis.

Summary

• SAM provides the LLM inference layer for AI-driven SEO insights within OpenSEO, hosted at every-app/sam.
• Every-App SDK supplies essential Cloudflare Workers, D1, and KV utilities imported in src/server.ts via defineApp, getLocalD1Url, and createAppRouter.
• Skill-Repo offers extensible AI agent skills for advanced keyword research and link prospecting, installable via npx skills add.
• OpenSEO's architecture demonstrates concrete integration patterns, with the SDK handling Cloudflare-specific infrastructure abstraction.
• The ecosystem supports both Docker containerization and Cloudflare Workers serverless deployment models.

Frequently Asked Questions

What is the relationship between SAM and OpenSEO?

SAM is every-app's dedicated large-language-model inference server. OpenSEO utilizes SAM to generate AI-driven SEO insights and visibility scores, processing search data through specialized AI models rather than relying solely on external API data.

How does the Every-App SDK enable Cloudflare deployment?

The SDK provides getLocalD1Url() for local D1 database emulation during development and defineApp() for configuring Cloudflare KV and D1 bindings, as implemented in src/server.ts. These utilities abstract the complexity of Cloudflare's serverless infrastructure, allowing OpenSEO to run seamlessly on Cloudflare Workers.

Can I use OpenSEO without the other every-app related projects?

Yes. OpenSEO functions independently for core SEO features like keyword research and rank tracking using the DataForSEO API. However, AI-driven insights require SAM, and Cloudflare deployments benefit significantly from the Every-App SDK utilities for database and KV management.

Where are the AI agent skills from Skill-Repo integrated?

Skills from the Every-App/skill-repo extend OpenSEO's capabilities for tasks like link prospecting and competitor analysis. They are installed via npx skills add every-app/open-seo and integrate with the platform's AI layer, extending the base functionality with specialized agent behaviors.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}