# Using AEBOT

Source: https://auditae.app/docs/aebot

AEBOT is the AI assistant that runs your AuditAE workspace from chat: what it can do, what a reply costs (about $1–2), WordPress permissions and free docs mode.

Open **AEBOT** from the sidebar (it lives on the Overview page). It's a chat backed by Claude Opus 5.5 (with Sonnet-powered specialist subagents for research, link-building, reputation, and page builds) and tool access to your sites, audits, competitors, schedule, billing, and (when connected) GA4 and Search Console. **It never fabricates numbers:** every figure in a reply comes from a tool call. Chat history is private per user and persists across sessions.

## What a reply costs

A typical reply costs **about $1–2**. Measured over 15 customer replies in the 30 days to 2026-10-01: median about $1.07, 90th percentile about $2.56, the largest $3.12. A reply that saves a report adds the 25¢ save fee (measured report replies came to about $2–3 with it), and a long multi-client research turn can cost more.

Each reply is billed on its real tokens. Markup is tiered by the Claude model running underneath: **Haiku 3×**, **Sonnet 10×**, **Opus 10×**. Cheap admin work (classification, extraction) stays cheap; deep reasoning carries the margin. AEBOT runs on **Opus 5.5**, so each turn is billed at input + output tokens × Anthropic's list price × **10×**, rounded up to the nearest cent (1¢ minimum). When AEBOT delegates to the research subagent, those tokens bill at Sonnet's lower list price instead.

The exact charge appears under each reply (`$0.XX used · $YY.YY left`) and your balance updates live on the [Billing](https://auditae.app/dashboard/billing) page. Buttons that hand a task to AEBOT from an audit show the typical cost next to the label, for example "Apply with AEBOT · about $1–2".

If your balance is below $1.50 when a turn starts, AEBOT refuses the request rather than running up debt, and offers a top-up instead (see below). Until your first purchase, a reply also stops when your balance reaches $0, so you never start with a debt. Prices for everything else are on [Credits, prices and top-ups](https://auditae.app/docs/credits).

## Adding credit without leaving the chat

When AEBOT stops for credit, the message offers the top-up right there:

1. Click **Add $N and continue**. N is the smallest top-up that covers the $1.50 minimum plus a long reply; if you haven't bought credit before, it's the $10 first top-up whenever that's enough. **Other amount** shows the other choices.
2. Pay in the Stripe checkout that opens inside the chat.
3. Once the credit lands, the chat says **Credit added. Continuing below.** and picks the task back up: a message that never ran is sent again, and a reply that stopped partway continues where it left off.

If your payment method sends you to another page to confirm (some banks do), you land on Billing after paying; click **Continue where you left off** to go back to the chat, and it resumes the same way. A design you attached isn't kept through that redirect, so re-attach it if AEBOT still needs it.

The same applies to the hand-off buttons on your audits. When your balance is below the minimum they read **Add credit, then ask AEBOT**: the chat opens with the top-up first and sends the task once it's paid.

## Tools AEBOT can call

### Inventory and site data

- `list_sites`: every site in your workspace with last-run citation rate.
- `get_site_summary`: headline stats for one site (latest rate, audit count, GA4 and Search Console status, default prompts).
- `list_trackers`: scheduled audits, cadence, paused or active state.

### Audit history and trends

- `list_audits`: audits newest first; optional site filter.
- `get_audit_summary`: per-prompt breakdown for one audit.
- `get_citation_trend`: daily citation rate over 7–90 days, zero-filled for missing days.
- `get_competitor_breakdown`: which competitors get mentioned how often, sorted by frequency.
- `count_cited_prompts_last_30d`: total cited cells in the last 30 days.

### Traffic

These need the site's GA4 property and Search Console site picked (see [Connect Google](https://auditae.app/docs/google)).

- `get_sessions_summary`: GA4 sessions vs the prior 30 days for one site.
- `get_top_landing_pages`: GA4 top landing pages by sessions.
- `get_top_organic_queries`: Search Console top queries by clicks.
- `get_traffic_timeseries`: GA4 daily sessions for the last 14 days.
- `query_gsc`: the full Search Console `searchAnalytics.query`. Slice by date, query, page, country, device; AEBOT uses this when you ask free-form questions about indexing, CTR, or query trends.

### Keyword rank tracking

- `list_tracked_keywords`: keywords tracked for a site, with latest rank, AI Overview citation status, and demand trend.
- `track_keyword`: add a keyword to rank tracking and immediately run a live SERP check and search-volume lookup. Returns rank, whether your domain is cited in the keyword's **AI Overview**, and the year-over-year volume trend. **$0.05**.
- `untrack_keyword`: stop tracking a keyword. Free.
- `refresh_keyword_rank`: re-check one tracked keyword's position, AI Overview citation, and volume trend now (instead of waiting for the weekly refresh). **$0.05**.
- `backfill_keyword_history`: one-time pull of up to 12 months of past rank and AI Overview history from the historical SERP database, so the trend isn't empty. **$0.25**, charged only if history is found.
- `keyword_research`: search volume, CPC, and related-keyword suggestions for a seed keyword via DataForSEO. **$0.25**.

More on rank tracking: [Rank tracking, mentions and site signals](https://auditae.app/docs/tracking-and-mentions).

### Specialist agents

AEBOT hands open-ended work to a focused sub-agent that shares your workspace's memory, then summarizes the result:

- `delegate_research`: a web-research agent for open-ended questions (competitor landscapes, "state of X", pricing surveys).
- `delegate_backlink_audit`: a link-building agent that finds link gaps vs competitors, vets attainable prospects, and drafts outreach.
- `delegate_reputation_scan`: a brand-reputation and AI-visibility agent that scans live mentions across the web and AI answers, triages sentiment, and drafts responses.

### Brand mention monitoring

- `explore_llm_mentions`: DataForSEO's historical LLM-mentions corpus (Google AI Overviews worldwide and ChatGPT US/EN) for a domain or keyword: every prompt citing the target, the answer, all cited sources with position, and a 12-month trend. Saves a report. **$0.75**.
- `explore_web_mentions`: open-web brand-mention scan (DataForSEO Content Analysis): news, blogs, forums, and listings mentioning a brand or keyword, each tagged positive, negative or neutral, optionally filtered to a content vertical. The web-side companion to the AI-citations corpus. Saves a report. **$0.25**.

### Schema autopilot

- `discover_brand_entities`: Wikidata-backed lookup of your organization's authoritative identifiers (Wikipedia, Crunchbase, social profiles). Free.
- `generate_schema`: JSON-LD scaffold for a page or post.
- `validate_schema`: lint a JSON-LD blob against schema.org.

### WordPress tools

Available when the AuditAE plugin is paired (see [Pair the AuditAE WordPress plugin](https://auditae.app/docs/wordpress-pairing)). What AEBOT may actually do depends on the pairing's permissions: see [What AEBOT can change on WordPress](https://auditae.app/docs/aebot#what-aebot-can-change-on-wordpress) below.

- **Read tools (free):** `wp_site_status`, `wp_list_recent_posts`, `wp_get_post`, `wp_get_post_links`, `wp_get_fields`, `wp_get_faq_schema`, `wp_get_post_schema`, `wp_get_organization_schema`, `wp_probe_schema`, `wp_get_llms_txt`, `wp_list_crawler_hits`, `wp_get_link_graph`, `wp_list_media`, `wp_get_media`, `wp_list_redirects`, `wp_suggest_redirects_from_404s`, `wp_list_form_submissions`.
- **Write tools (5¢ per standard write):** `wp_create_post`, `wp_update_post` (both accept `status: future` and a date to schedule a post), `wp_trash_post` (reversible: moves to the WordPress Trash), `wp_set_post_seo`, `wp_set_faq_schema`, `wp_delete_faq_schema`, `wp_set_post_schema`, `wp_delete_post_schema`, `wp_set_organization_schema`, `wp_delete_organization_schema`, `wp_set_llms_txt`, `wp_reset_llms_txt`, `wp_insert_internal_link`, `wp_upload_media`, `wp_update_media`, `wp_rename_media`, `wp_add_redirect`, `wp_delete_redirect`, and on the AuditAE AI Autopilot theme `wp_edit` (page fields and site-wide brand) and `wp_add_record` (services, locations, FAQs and other records pages loop over).
- **Elementor and block-editor pages** (plugin 0.29.0+): on an Elementor page, AEBOT edits text in place with exact find-and-replace edits (`wp_update_post` with `replacements`). Whole-body rewrites are refused there, and fields bound to Elementor Pro dynamic tags are skipped. On block-editor pages the same edits also update the text blocks keep in their settings (Yoast or Rank Math FAQ blocks, for example), so edited blocks stay valid in the editor.
- **Page Composer** (block editor design): `wp_read_page_blocks` (free read of a post's block markup so AEBOT can edit in place) and `wp_design_page` at **$0.25** (AEBOT writes block markup, such as a hero, columns, FAQ, CTA or table, as the post body; the page stays fully editable in the WordPress block editor). Ask AEBOT to "design a landing page with X" or "add a hero to this page". When the design includes an FAQ section, AEBOT also writes the matching FAQPage JSON-LD in the same turn.
- **Whole-page builder** (`delegate_build`): for a full landing, pricing or about page, or a complete redesign, AEBOT hands the job to a dedicated builder specialist that runs in the background (a few minutes, longer than a chat turn), writes the finished page, and **emails you** when it's live (it also leaves a note in the chat). On the companion **AuditAE AI Autopilot** theme it writes a server-rendered template (copy and brand live in editable fields, swapped in on every render); on any other theme it writes blocks. The **$0.25** page write is billed when it ships, plus the builder's own tokens.
- **Design handoff:** have a design already? Attach it in the chat: click the **paperclip** and drop an `.html` file or a `.zip` of the design, then ask AEBOT to build it onto a page. The builder *adapts* it into the site's section library and brand kit (not a pixel-for-pixel copy), so the result stays on-brand and editable. Local images inside a zip come through as flagged placeholders for you to swap.

### Technical SEO

- `get_latest_technical_audit`: last cached crawl and Core Web Vitals for a site. Returns nothing if none has run yet.
- `run_technical_audit`: fetches the site's homepage and pulls PageSpeed Insights for mobile and desktop. Free, no credit debit. Takes 15–30s.
- `crawl_site`: multi-page crawl beyond the homepage. **$0.01 per page** (about $0.25 for a typical 25-page site).
- `detect_tech_stack`: detects the site's CMS, platform and stack (WordPress, Shopify, Webflow, frameworks, analytics) via DataForSEO Domain Analytics, so AEBOT tailors fixes to how you publish. Free.
- `get_backlink_summary`: off-page authority for the site or any competitor domain: domain rank (0–1000), referring domains, dofollow split, spam score, broken links. Free, no credit debit.

### Site management

- `create_site`: adds a new site (brand and domain, with optional prompts and competitors). Free. AEBOT confirms before creating.
- `archive_site`: hides a site from the list (audit history is preserved). AEBOT waits for an explicit "yes" before calling it.
- `update_site_prompts`: manage the site's default prompt list. Three actions: **add** (append, deduped, no confirmation needed), **remove** (drop named prompts), **replace** (overwrite the whole list). Free. AEBOT confirms before remove or replace; add is safe and just goes.
- `update_site_competitors`: the same three actions (**add**, **remove**, **replace**) for the site's competitor-domain list, which drives share-of-voice math. Free.

### Saving reports

- `save_report`: writes the AEBOT-authored Markdown to the site's **Reports** tab inside AuditAE. Flat **$0.25** per saved report on top of the chat turn cost. Re-openable, deletable, and kept with the site.

### Email and Drive

These need the Google connection (see [Connect Google](https://auditae.app/docs/google)).

- `send_email`: composes and sends mail from your Gmail address (plain or HTML, with optional CC and BCC). AEBOT shows recipients and body and waits for explicit approval before sending. **Cannot read your inbox.** No per-email surcharge; it costs only the chat turn.
- `save_to_drive`: saves a report or any Markdown content as a Google Doc (or `.md` file) in your Drive, optionally inside a specific folder ID. **Restricted by Google to files AuditAE created**, so we can't see anything else in your Drive. No per-file surcharge.

### Billing and actions

- `get_billing_summary`: balance, monthly spend, monthly check count.
- `start_audit`: runs a new audit against a site inside the chat (about two minutes of engine time; checks that don't finish in time come back as a partial result and aren't billed). If the workspace already has 4 audits running, it's queued and starts within a minute of one finishing. Real money, so AEBOT confirms site, prompts, and engines back to you before calling.
- `create_tracker`, `set_tracker_paused`, `delete_tracker`: schedule, pause or remove a site's weekly or monthly audit. Each run bills when it fires; AEBOT confirms before scheduling.
- `get_fix_plan`: the exact edits that get a page cited, from the site's audits. **$0.50** per plan; the same request within 24 hours is free. See [Apply a fix plan and check it worked](https://auditae.app/docs/fix-plan).
- `mine_competitor_prompts`: prompts where a competitor was cited and you weren't, from the site's audit history (**5¢**). `find_content_gap`: Google keywords a competitor ranks for and you don't (**$0.25**).
- `query_ga4`: any GA4 report (events, conversions, channels, devices), the GA4 counterpart of `query_gsc`. Free.
- `show_chart`: draws a chart card in the chat (citation trend, share of voice, GA4 sessions, search traffic) from your own data. Free.
- `list_reports`, `get_report`: find and read a site's past reports, audits and crawls without re-running anything. Free.

If you ask about Google data and a connection isn't set up, AEBOT tells you to open the site's **Settings** (gear) → **Connections** and pick a property. It won't guess.

## What AEBOT can change on WordPress

A paired site has four permissions, set in WP admin → Settings → AuditAE under **What AEBOT can do**:

| Permission | Label in the app | What it allows |
|---|---|---|
| `read` | Read site data (free) | Read posts, SEO settings, schema, llms.txt, media, form submissions and the crawler log. |
| `draft` | Create + update draft posts | Create and edit draft posts, upload media, and move drafts to the Trash. |
| `publish` | Publish posts directly | Publish, schedule, and edit posts that are already live (including internal-link inserts). |
| `write_seo` | Write SEO settings | SEO titles and descriptions, schema, FAQ schema, llms.txt, redirects and image details. |

A new pairing starts with `read` and `draft`. Both the app and the plugin enforce the switches, so a write the pairing doesn't allow is refused on both sides.

AEBOT knows each paired site's permissions on every turn and won't offer an edit the pairing can't make:

- **Without `write_seo`,** it doesn't apply SEO meta, schema, FAQ schema, llms.txt or redirects. It gives you the exact, paste-ready edits instead and names the **Write SEO settings** switch that would let it apply them.
- **On a read-only pairing,** it doesn't offer drafts either.
- **On your audits,** the fix buttons say what will happen: **Apply with AEBOT** when `write_seo` is on, **Show me the exact edits** when the site is paired without it, and **Do it with AEBOT** otherwise, or when the fix is on another site (a review listing or a forum thread, say).
- **From wp-admin** (plugin 0.32.0 and later), the fix buttons on the plugin's AI Readiness Score tab open AEBOT on that site. It checks the permissions before promising anything and doesn't start an audit unless you ask for one.

If a WordPress call fails, AEBOT checks `wp_site_status` and tells you what the plugin reported. Per-tool detail is on [What AEBOT can do at each WordPress permission level](https://auditae.app/docs/wordpress-permissions).

## Reports

Ask "monthly report", "technical summary", or "competitive landscape" and AEBOT chains tool calls and writes a structured Markdown report (Citation, Competitors, Traffic, Schedule sections). Specific by default: "rate dropped from 45% to 32% over 14 days" rather than "rate is fine".

AEBOT can save a report three ways:

- **Inside AuditAE** via `save_report`: kept on the site's **Reports** tab, re-openable later. **$0.25** flat plus the chat turn.
- **To Google Drive** via `save_to_drive`: written as a Google Doc or `.md` file in your Drive. Requires the Drive scope. No surcharge.
- **By email** via `send_email`: sent to one or more recipients from your Gmail address. Requires the Gmail scope. No surcharge.

A walkthrough of a real monthly report: [Monthly report in ten minutes](https://auditae.app/blog/monthly-report-in-ten-minutes).

## Examples that work well

- "Monthly report for Notion"
- "Show me prompts that are cited on ChatGPT but not Perplexity."
- "How much credit do I have left and what's my burn rate?"
- "Run an audit for Linear with these prompts: 'best PM tool', 'Linear vs Asana'."
- "Which competitors show up most in my answers?"
- "Remember that our ideal customer is a 10–50 person HVAC company." Saved to the site's brief; see [Memory](https://auditae.app/docs/memory).

## Documentation mode (free)

Click the **Documentation** chip in the chat, or open [/dashboard/overview?docs=1](https://auditae.app/dashboard/overview?docs=1), for free answers taken only from these docs. Docs answers show `$0.00 · free` and never touch your balance (up to 30 questions a day). **Back to AEBOT** switches back to the billed assistant, which can look at your data and act on it.

When the docs don't cover a question, the answer says so and offers **Ask AEBOT instead** (billed) or **Send to support**.

What AEBOT looks like in practice for marketing work: [AI marketing analyst](https://auditae.app/ai-marketing-analyst).