# Where to Find the OpenSEO Documentation: Official Links and Repository Paths

> Find OpenSEO documentation easily. Access live web docs at openseo.so or explore markdown files within the every-app/open-seo repository. Get started today!

- Repository: [Every App/open-seo](https://github.com/every-app/open-seo)
- Tags: getting-started
- Published: 2026-09-08

---

**OpenSEO documentation is hosted both as live web docs at openseo.so and as version-controlled markdown files in the `docs/` and `web/content/docs/` directories of the every-app/open-seo repository.**

The OpenSEO project maintains comprehensive documentation across two synchronized channels. Whether you prefer browsing rendered websites or reading source files directly in the every-app/open-seo GitHub repository, all guides remain aligned with the current codebase.

## Official Web Documentation at openseo.so

The primary hosted documentation lives on the openseo.so domain, providing searchable guides for end users.

### MCP Server Setup Guide

The Multi-Channel Platform (MCP) server documentation at `https://openseo.so/docs/mcp` explains how to run the server that AI agents connect to. This guide covers configuration requirements and runtime parameters necessary for establishing agent communication channels.

### Agent Skill Installation

For adding OpenSEO capabilities to AI agents, the hosted guide at `https://openseo.so/docs/skills/setup` demonstrates how to integrate skill files into various agent frameworks. Both hosted links are referenced in the repository's [`README.md`](https://github.com/every-app/open-seo/blob/main/README.md) according to the source code analysis.

## In-Repository Documentation Structure

All documentation source files live alongside the code, enabling offline reading and version-controlled updates.

### Self-Hosting Guides

Docker and Cloudflare deployment instructions reside in the repository root's `docs/` folder:

- **[`docs/SELF_HOSTING_DOCKER.md`](https://github.com/every-app/open-seo/blob/main/docs/SELF_HOSTING_DOCKER.md)** – Containerized deployment instructions at `https://github.com/every-app/open-seo/blob/main/docs/SELF_HOSTING_DOCKER.md`
- **[`docs/SELF_HOSTING_CLOUDFLARE.md`](https://github.com/every-app/open-seo/blob/main/docs/SELF_HOSTING_CLOUDFLARE.md)** – Cloudflare-specific hosting configuration at `https://github.com/every-app/open-seo/blob/main/docs/SELF_HOSTING_CLOUDFLARE.md`

### Skill Setup Instructions

The detailed "Set up OpenSEO Agent Skills" page lives at [`web/content/docs/skills/setup.md`](https://github.com/every-app/open-seo/blob/main/web/content/docs/skills/setup.md). This file contains the source markdown for the interactive installation guide, covering automated and manual skill installation methods for various agent platforms.

### Additional Reference Materials

The `docs/` directory also contains markdown files covering MCP configuration, pricing models, local development workflows, and contribution guidelines. The [`plugins/openseo/README.md`](https://github.com/every-app/open-seo/blob/main/plugins/openseo/README.md) file describes the OpenSEO plugin that bundles MCP and skills functionality.

## Installing OpenSEO Skills

After locating the documentation, install OpenSEO skills using the following methods documented in [`web/content/docs/skills/setup.md`](https://github.com/every-app/open-seo/blob/main/web/content/docs/skills/setup.md).

Install all OpenSEO skills for any agent:

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

```

Install only the SEO-project-setup skill for Claude Code:

```bash
npx skills add every-app/open-seo --skill seo-project-setup --agent claude-code

```

Run a skill after installation by typing the slash command in your agent's chat interface:

```bash
/seo-project-setup

```

For manual installation in custom agent directories:

```bash
git clone https://github.com/every-app/open-seo.git

# For Codex

mkdir -p ~/.codex/skills
cp -R open-seo/.agents/skills/* ~/.codex/skills/

# For Claude Code

mkdir -p ~/.claude/skills
cp -R open-seo/.agents/skills/* ~/.claude/skills/

```

## Summary

- **OpenSEO documentation** is available both as hosted web content at openseo.so and as markdown source files in the every-app/open-seo repository.
- **Live docs** include the MCP setup guide (`/docs/mcp`) and skill installation guide (`/docs/skills/setup`).
- **Repository docs** reside in `docs/` for self-hosting and `web/content/docs/` for skill guides.
- **Key files** include [`README.md`](https://github.com/every-app/open-seo/blob/main/README.md), [`SELF_HOSTING_DOCKER.md`](https://github.com/every-app/open-seo/blob/main/SELF_HOSTING_DOCKER.md), [`SELF_HOSTING_CLOUDFLARE.md`](https://github.com/every-app/open-seo/blob/main/SELF_HOSTING_CLOUDFLARE.md), and [`web/content/docs/skills/setup.md`](https://github.com/every-app/open-seo/blob/main/web/content/docs/skills/setup.md).
- **Offline access** is available by cloning the repository and reading the markdown files directly from the source tree.

## Frequently Asked Questions

### Where is the official OpenSEO documentation hosted?

The official OpenSEO documentation is hosted at openseo.so, with specific guides available at `openseo.so/docs/mcp` for MCP server setup and `openseo.so/docs/skills/setup` for agent skill installation. These hosted versions are generated from the markdown source files stored in the every-app/open-seo repository.

### Can I read the OpenSEO documentation without internet access?

Yes. Because the OpenSEO documentation lives as markdown files in the `docs/` and `web/content/docs/` directories of the every-app/open-seo repository, you can clone the repository and read all guides offline. The files are version-controlled alongside the source code, ensuring documentation stays synchronized with features.

### What is the difference between the docs/ and web/content/docs/ directories?

The `docs/` directory contains operational guides like Docker and Cloudflare self-hosting instructions ([`SELF_HOSTING_DOCKER.md`](https://github.com/every-app/open-seo/blob/main/SELF_HOSTING_DOCKER.md) and [`SELF_HOSTING_CLOUDFLARE.md`](https://github.com/every-app/open-seo/blob/main/SELF_HOSTING_CLOUDFLARE.md)), while `web/content/docs/` contains the source files for the hosted website documentation, including the skill setup guide at [`skills/setup.md`](https://github.com/every-app/open-seo/blob/main/skills/setup.md). Both directories are maintained within the same repository and cross-referenced in the [`README.md`](https://github.com/every-app/open-seo/blob/main/README.md).

### How do I install OpenSEO skills after finding the documentation?

Install skills using the `npx skills add every-app/open-seo` command with appropriate flags, or manually copy files from `.agents/skills/` to your agent's skill directory (e.g., `~/.codex/skills/` or `~/.claude/skills/`). The complete installation commands are documented in [`web/content/docs/skills/setup.md`](https://github.com/every-app/open-seo/blob/main/web/content/docs/skills/setup.md) and summarized in the repository's [`README.md`](https://github.com/every-app/open-seo/blob/main/README.md).