Optia - Chrome Extension

A Chrome extension that analyzes web pages for SEO optimization and provides AI-powered recommendations (Claude, by Anthropic) to improve search rankings. Free tier included; Optia Pro adds more AI, advanced analysis, and bring-your-own-key.

Website: https://pmdevsolutions.github.io/Optia/ Privacy Policy: https://pmdevsolutions.github.io/Optia/privacy.html Support: https://github.com/PMDevSolutions/Optia/issues

ℹ️ Remaining external-property migration (AI SEO Copilot → Optia). The repo, UI, docs, site, and store assets are fully renamed to Optia, and the per-check "Learn more" links now point at Optia's own docs (site/docs/, generated by scripts/build-docs-site.mjs). One predecessor property is still referenced and must be migrated manually by the project owner:

• Figma design file — …/AI-SEO-Copilot-design (referenced in app/QA-PROMPT.md).

Features

• Real-time SEO Analysis — instant 0–100 scoring for titles, meta descriptions, headings, images, links, structured data, and more. Unlimited and free; analysis runs locally in your browser.
• AI-Powered Recommendations — one-click optimized titles, meta descriptions, H2s, and alt text, powered by Claude (Anthropic). 25/month free with no account; Optia Pro raises that to 1,000/month.
• Optia Pro ($5/month or $50/year, billed via Stripe) — more AI, page-type-aware Advanced Analysis, multi-language output, schema recommendations, and bring-your-own Anthropic key for unlimited AI.
• Keyword Optimization — track keyword usage across all page elements.
• One-Click Copy — copy suggestions directly to your clipboard.
• Side panel UI — recommendations alongside the page you're optimizing; light and dark themes.

How the freemium model works (open-core)

Optia is open-core: this public repo ships the extension and everything free — local SEO analysis, the UI, and the client side of licensing (paywall, checkout initiation, entitlement verification). A separate private repo (optia-backend, a Cloudflare Worker) holds everything that must be trusted: Stripe billing, license minting and Ed25519 signing, and the metered AI proxy that fronts Anthropic with a server-funded key.

Pro is a signed claim, not client state. After Stripe confirms payment, the backend signs a short-lived entitlement; the extension only bundles the public verification key, so a modified client can flip its own UI gates but can never mint Pro, exceed server-metered quotas, or steer checkout. The full security model — diagram, trust boundary, key rotation, and contributor rules (in short: never add paid/secret server logic to this repo) — is in docs/architecture.md; the feature-by-feature gating matrix is in docs/free-vs-pro-gating.md.

Privacy & Data Handling

The user-facing policy lives at pmdevsolutions.github.io/Optia/privacy.html (source: site/privacy.html, mirrored in docs/privacy-policy.md — keep them in sync). The short version:

• SEO analysis runs locally; page content is not transmitted by browsing or analyzing.
• AI requests send only the keyword + relevant page snippets — to the Optia backend (Cloudflare Workers → Anthropic) in hosted mode, or directly to Anthropic in Pro bring-your-own-key mode (the key never touches the backend; enforced server-side).
• The backend stores licenses and coarse usage counters, never page content or profiles. Billing is handled entirely by Stripe — no card data ever touches Optia.
• No analytics, no tracking, no ads, no data sales. Data requests: open an issue.

Chrome Web Store data-safety answers are maintained in docs/chrome-web-store-data-disclosure.md; the full listing source is docs/chrome-web-store-listing.md.

Quick Start

See the detailed setup instructions in app/README.md.

TL;DR:

npm install -g pnpm
cd app
pnpm install
pnpm build

Then load the app/dist folder in Chrome as an unpacked extension.

Project Structure

optia-extension/
├── app/                    # Chrome extension source code
│   ├── src/                # React + TypeScript source
│   ├── e2e/                # Playwright extension E2E + MV3 compliance tests
│   ├── dist/               # Built extension (load this in Chrome)
│   └── manifest.json       # Chrome extension manifest (MV3)
├── site/                   # GitHub Pages site (landing, privacy, billing pages)
├── marketing/              # Store assets pipeline (screenshots, promo tile)
├── docs/                   # Listing, privacy, release & launch documentation
├── .claude/                # Claude Code AI agent configuration
└── README.md               # This file

Development

cd app
pnpm install            # Install dependencies
pnpm dev                # Browser dev preview (no extension loading needed)
pnpm dev:ext            # Extension build in watch mode
pnpm build              # Build for production
pnpm test               # Unit tests (Vitest)
pnpm test:e2e           # Extension E2E + MV3 compliance (build first)

Releases are automated with release-please — see docs/RELEASING.md. The Chrome Web Store upload zip is attached to every GitHub Release. The launch runbook is docs/launch-checklist.md.

Tech Stack

• React 19 + TypeScript + Tailwind CSS + Vite (crxjs)
• Zustand — state management
• Claude (Anthropic) — AI recommendations, via the Optia backend proxy or the user's own key
• Cloudflare Workers backend (optia-backend) — licensing, Stripe billing, metered AI proxy
• Vitest + Playwright — unit and extension E2E testing

License

MIT

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests (pnpm test)
5. Submit a pull request