Choose your path: Inspect a page · Plan a brief · Decode an export
New here? Install SEO-pro first.
Open a quest, copy its prompt, and bring your evidence to ChatGPT.
chatgpt-seo
Turn a page, draft, or SEO export into a sourced fix plan inside ChatGPT.
SEO-pro by Daniel Agrici brings focused SEO workflows to the conversation: inspect the evidence, explain the problem, and give you a change you can check.
Your loadout
Status: manual ZIP installation. Public directory submission and approval are pending. This is an independent plugin, not made or endorsed by OpenAI.
Quick start
- Download SEO-pro 0.2.16, then choose View raw on GitHub's file page. Use this plugin ZIP, not GitHub's source-code ZIP.
- In ChatGPT, open Plugins, choose Add, then Upload plugin archive. Upload the ZIP and choose Add plugin.
- Open the plugin's settings and choose Install plugin.
- Choose Try in chat, or start a new chat with SEO-pro selected.
- Paste a public page URL or attach a draft/export, then ask one of the questions below.
The upload option and available tools depend on your ChatGPT account and workspace. If the option is unavailable, see installation help. Downloading this repository does not install the plugin. No separate SEO account, API key, or Google connection is required.
Choose your quest
Start with what you have. Open a card for a copyable prompt and the response structure to request.
Quest 01: Inspect a page
Ask ChatGPT:
Review this page for SEO: [paste your page URL]. Show the
evidence, prioritize the fixes, and draft a better title and
description using only facts on the page. For each fix, tell
me how to verify the change.You leave with: a page diagnosis, supported metadata options, and checks for each recommended change. If the page cannot be opened, supply its HTML or text.
Response structure: evidence observed, finding, proposed change, verification, and anything still unknown.
Quest 02: Brief a writer
Ask ChatGPT:
Create an SEO content brief about [topic] for [audience].
Include the search intent, outline, facts we need to source,
and useful internal links from my site: [site or URL list].
Label ideas that lack measured search data as planning
assumptions.You leave with: a writer-ready brief, an outline, and evidence requirements. No invented search volumes or claims about the audience.
Response structure: audience and intent, page purpose, outline, source checklist, internal links, and review criteria.
Quest 03: Read a Search Console export
Ask ChatGPT:
Analyze this Search Console CSV for [date range]. Find pages
worth reviewing and explain clicks and CTR. Check the
columns and date coverage before calculating anything. Flag
missing context before drawing conclusions.You leave with: calculations for the supplied rows, supported page/query opportunities, and the next checks. An export does not grant live account access.
Response structure: coverage, calculations, opportunities, limitations, and the evidence needed next.
Skill tree
- Skills: All 27 workflows, selected for your task.
- Commands: Nine Python entrypoints for files you provide, when execution is available.
- References and templates: Decision packs and report formats.
- FLOW: 41 attributed routes for organizing an initiative.
Choose a branch to see the workflow behind it.
| Bring | Get back |
|---|---|
| A site or page | Evidence, prioritized fixes, and verification steps |
| Technical evidence | Crawl, canonical, index-control, and rendering findings |
| A draft or topic | Content review, briefs, or sourced comparison drafts |
| Markup, XML, or locale URLs | Structured-data, sitemap, or hreflang checks and drafts |
| Search data, links, or Maps exports | Analysis scoped to the supplied data |
| Business or product pages | Local or ecommerce recommendations from real facts |
| Keywords or a business goal | Page targets, internal links, and a practical roadmap |
| AI-search or agent-readiness evidence | Access, usefulness, and task-completion checks |
| Before/after snapshots | Observable changes and a regression-check plan |
| An image request | Requested visuals through ChatGPT's integrated image tool, when available |
The full capability map covers all 27 skills, including FLOW, search experience, programmatic pages, image review, and implementation handoffs. These are workflows, not 27 external API tools.
What happens in ChatGPT
You choose a task and its evidence. ChatGPT loads the relevant skill and supporting references, uses the tools available in that chat, and connects each finding to a fix and a verification step.
Public browsing can inspect accessible pages. Account analysis uses your exports or a separately authorized read tool. Nine bundled Python commands can inspect selected HTML, XML, CSV, JSON, and image headers when file execution is available. They use Python's standard library and do not fetch URLs. Without execution, the workflow explains which checks it could perform manually.
The plugin includes no hosted MCP server, OAuth client, crawler installation, recurring monitor, or paid data integration. It cannot guarantee rankings, traffic, indexing, rich results, or AI citations. Missing evidence stays unknown.
Your data
The package has no publisher-operated server or telemetry. It does not send your task inputs or results to Daniel Agrici. ChatGPT and tools you authorize process data under their own settings and policies. Files may remain in your chat or workspace.
Share only the material the task needs. Remove credentials and unrelated personal information from exports. GitHub issues are public: use a small, redacted example for support.
Read the privacy statement and usage terms.
Field guide
Is this the old Codex SEO suite?
This repository is being repurposed for the already-built ChatGPT package. The former Codex implementation is a separate product; its installers, hooks, agents, and provider integrations are not bundled here. See the transition notes before changing an existing installation.
Do I need Python or an API key?
Normal ChatGPT use requires no local Python setup or API key. The optional offline commands need Python 3.10 or newer in an execution-capable host. Image creation needs the host's integrated image tool. Unavailable capabilities are reported rather than simulated.
Can it read my Google accounts?
No Google connection is included. Upload an export, or explicitly authorize a suitable read tool already available in your chat. Never paste an authentication token or password.
Does a schema check mean I qualify for rich results?
No. JSON syntax, visible-fact agreement, Schema.org validity, and Google's eligibility requirements are separate checks. The report states which ones were actually verified.
Can it publish fixes or contact someone for me?
It can prepare requested code, drafts, and implementation briefs. Publishing, account changes, and sending require appropriate tools and explicit authorization. No lead form or contact tool is included.
What has been tested?
The repository includes file-based regression tests and deterministic package validation. Earlier private-host tests have separate versioned evidence. Neither establishes public directory approval or identical behavior on every ChatGPT surface. See verification and release status.
Support and development
Use Support for installation questions, bugs, and privacy questions. For changes to the package, start with Contributing. The public source and license permit you to inspect and adapt it without joining a community or following a publisher link.
Publisher community: AI Marketing Hub Pro.
License and attribution
MIT applies to the code and workflows except the attributed FLOW material, which uses CC BY 4.0. Read NOTICE for the boundary and logo rights.
Adapted from the public Claude SEO project at its recorded commit. Provenance retains the source and adaptation details. No private Pro source is included.