AEOForgedAEOForged
Join

Getting Started

From zero to your first score in under 5 minutes

Last updated

AEOForged helps you make content that AI answer engines can find, understand, and cite. Whether you're building a site in your IDE, managing client sites, or asking an agent to set you up — you use the same platform, with different starting doors.

Page last updated .

Prefer an agent?

Two public doors open the same free diagnostic → private room path. Humans confirm the brand profile and choose packages; agents stop at payment.

Ask your agent

Copy a setup prompt into Cursor or Claude Code. Your agent runs the free diagnostic; the room link arrives by email.

/for-agents

Start yourself

Enter your site URL and email. We build a brand profile, run fit probes, and email a private room — no new login to create.

/start

Agent skills (high level): /docs/skills — free audit, self-serve loops, Fix Programme, content creation, authority, and related packs under /skills/. Packages after the free audit: /pricing and /pricing (Monitor, Grow, Dominate, and one-time fix options).

Signed-in paths

After you have an account, pick the path that matches how you work. Onboarding asks whether you're building a site or managing sites for clients — both get API access and MCP.

Building a site

You write content in your IDE (Cursor, VS Code, Claude Code) and want AI-grounded research, scoring, and structured data without leaving your editor.

  1. 1Create an API key at Settings → API Keys
  2. 2Connect via MCP or call the REST API directly
  3. 3Run research on your topic (10 credits)
  4. 4Write your article in your IDE using the research
  5. 5score it (free) — iterate until 80+
  6. 6Generate schema JSON-LD (free), publish

Managing client sites

You manage one or more websites and want to audit them, fix issues, and deliver results to stakeholders.

  1. 1Add a client at Clients and create a project
  2. 2Run diagnose for a free bounded site audit
  3. 3Work through the action queue — claim, fix, mark done
  4. 4Connect an agent (handoff / MCP) or fix via CMS/repo
  5. 5verify-page to confirm fixes landed
  6. 6Create a curated report and share with your client

First 5 minutes

Confirm your API key works, see what tools are available, and score something — all free. Full catalog: 30 tools via GET /api/v1/onboard.

1

Check your account

GET /api/v1/me · Free

Confirms your API key is valid and shows your tier, credit balance, and per-tool costs.

curl -H "Authorization: Bearer aeo_sk_YOUR_KEY" \
  https://aeoforged.com/api/v1/me
2

Discover tools and workflows

GET /api/v1/onboard · Free

Returns the full tool catalog with costs, the 8-dimension scoring rubric, recommended workflows, and playbooks. Agents should read this before calling any paid tool.

curl -H "Authorization: Bearer aeo_sk_YOUR_KEY" \
  https://aeoforged.com/api/v1/onboard
3

Score your first page

POST /api/v1/score · Free

Pass any markdown or a live URL and get an 8-dimension AEO score (0–100) with prioritised suggestions. Scoring is always free, so use it on every edit.

curl -X POST \
  -H "Authorization: Bearer aeo_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://yoursite.com/any-page"}' \
  https://aeoforged.com/api/v1/score

Check the X-AEO-Score and X-AEO-Weakest response headers for a quick summary.

Credits and honesty

What's free

  • Scoring — unlimited, always 0 credits
  • Schema generation — JSON-LD, free
  • Extract — snippet formatting, free
  • Factcheck — deterministic grounding check, free
  • Site audit (diagnose) — free bounded audit: scores discovered pages and deep-analyzes a prioritized set, ~3 per day per account
  • Crawlability — AI bot access check, free
  • Agent ready — probe-based operability check, free
  • Verify page — re-score a URL against an audit baseline, free

What costs credits

  • Research — 10 credits (deep: 15)
  • Outline — 3 credits
  • Write — 8 credits
  • Polish — 2 credits
  • Share of Voice — 10 credits (Brave-search proxy — labelled as likely visibility, not confirmed citations)

Full cost table: GET /api/v1/me → tool_costs. See also /docs/api.

What we measure and what we don't

AEOForged scores measure publish readiness — structure, direct answers, schema, entity coverage, E-E-A-T signals, recency, readability, and extractability. We do not guarantee that scored content will be cited by any AI answer engine. Measured page citations (ChatGPT, Perplexity, Gemini) are tracked separately in Monitoring; Brave-based visibility signals stay labelled as a proxy.

Next steps

Ask your agent

Copy a setup prompt — free diagnostic + room

Agent Skills

Downloadable SKILL.md packs for Cursor & Claude Code

MCP Setup Guide

Connect Cursor or Claude Code in one config

Audit Workflow

Run a site audit, fix issues, deliver results

Post-Publish Monitoring

Track measured citations after you publish

REST API Reference

Full endpoint docs with request/response examples