@ainyc/canonry 1.46.0 → 1.48.0

package/assets/agent-workspace/skills/canonry-setup/references/aeo-analysis.md

@@ -0,0 +1,130 @@
+# AEO Analysis: Interpreting Canonry Results
+
+## What Citation Means
+
+A "cited" keyword means the client's domain appeared in an AI provider's response when that query was asked. It does NOT mean:
+- The AI recommended them positively
+- The citation is prominent
+- It will persist on the next sweep
+
+A "not-cited" keyword means the AI answered without mentioning the client at all.
+
+## Reading Evidence Output
+
+```
+✓ cited  AEO Agency NYC             ← branded/direct match
+✓ cited  best plumber brooklyn
+✗ not-cited  how to fix a leaky faucet  ← informational gap: no page for this topic
+✗ not-cited  emergency plumber near me  ← competitive gap: others cited instead
+```
+
+### Keyword Categories
+
+**Branded/direct keywords** (e.g., "[business name] [city]"):
+- If cited: good — entity is established for core queries
+- If not cited: urgent — something broken at a fundamental level (indexing, schema, llms.txt)
+
+**Competitive keywords** (e.g., "best [service] [city]"):
+- If not cited: check who IS cited — competitor analysis needed
+- Harder wins; require established authority and trust signals
+
+**Informational/how-to keywords** (e.g., "how to [do X]"):
+- If not cited: almost always a content gap — no page targeting this topic, or it's not indexed
+- High-leverage — informational content positions a site as authoritative to AI models
+
+## Using Analytics
+
+### Citation Rate Trends (`--feature metrics`)
+Shows citation rate over time across providers. Use to identify:
+- Improving or declining visibility trends
+- Provider-specific performance differences
+- Impact of content/indexing changes over time
+
+**Key phrase normalization:** When new key phrases are added to a project mid-history, canonry automatically normalizes each time bucket to only include key phrases that existed before that bucket started. This prevents newly-added (typically uncited) key phrases from creating a false drop in the citation rate trend. The chart displays dashed vertical annotation lines at points where key phrases were added (e.g. "+3 kp"), and each bucket's tooltip shows the key phrase count ("kp") used for that bucket's calculation.
+
+### Gap Analysis (`--feature gaps`)
+Categorizes keywords as cited, gap (competitor cited but you're not), or uncited (nobody cited). Priorities:
+- **Gap keywords** are highest priority — competitors are winning these
+- **Uncited keywords** may need content or may be too broad
+
+### Source Breakdown (`--feature sources`)
+Shows which source categories AI models cite for your keywords. Helps identify:
+- Whether competitors dominate specific categories
+- Content format opportunities (FAQ, how-to, comparison pages)
+
+## Diagnosing Citation Gaps
+
+### Step 1: Check indexing first
+Not cited ≠ bad content. Often the page isn't indexed yet.
+```bash
+canonry google coverage <project>
+```
+If key pages are "unknown to Google," submit them before drawing conclusions.
+
+### Step 2: Check if content exists
+Is there a page on the site targeting that keyword? If not, that's the gap — not a canonry or provider issue.
+
+### Step 3: Check competitors
+For competitive keywords, if others are cited and the client isn't:
+- Do competitors have more specific, dedicated pages?
+- Do they have stronger schema/structured data?
+- Are they more established in the index?
+
+Run `canonry evidence <project> --format json` and check `competitorOverlap` in snapshots.
+
+### Step 4: Check across providers
+Gemini, OpenAI, Claude, and Perplexity may behave differently. One citing a domain while another doesn't is normal — each has its own knowledge base and update schedule.
+
+### Step 5: Check analytics trends
+```bash
+canonry analytics <project> --feature gaps --window 30d
+```
+Look for patterns: are gaps growing or shrinking? Are new competitors appearing?
+
+## Trend Interpretation
+
+**Stable cited** — monitor for regressions, no action needed.
+
+**New citation** (was not-cited, now cited) — win. Correlate with what changed: new content, indexing, schema update.
+
+**Regression** (was cited, now not-cited) — investigate immediately:
+- Did a competitor page launch?
+- Did the page get deindexed or go down?
+- Did the model update?
+- Check `canonry google deindexed <project>` for index losses
+
+**Fluctuation** (cited in some runs, not others) — normal for competitive keywords. Track trend over 5+ runs before drawing conclusions. AI answers are non-deterministic.
+
+## What to Recommend
+
+### Low overall citation (< 50%)
+1. Audit indexing — `canonry google coverage <project>`
+2. Submit unindexed pages to Google Indexing API
+3. Submit sitemap to Bing WMT + send IndexNow batch
+4. Check core pages for schema (LocalBusiness / Organization / FAQPage)
+5. Map uncited keywords to pages — which have no corresponding page?
+
+### Branded terms not cited
+Red flag. Check:
+- Is the homepage indexed?
+- Does `llms.txt` exist and list the business clearly?
+- Does schema include the exact brand name in `name` field?
+
+### Informational terms not cited
+Content strategy play:
+- Does a page targeting this topic exist? If not, create it.
+- Is it indexed? If not, submit it.
+- Is it structured for AI extraction? (FAQ schema, clear H2s, definition-style answers)
+
+### Provider variance (cited on one, not others)
+Expected — each provider has independent knowledge. Focus on the ones that matter most for the client's audience. Don't over-optimize for one provider at the expense of others.
+
+## The AEO Timeline Reality
+
+- Site changes → weeks/months to appear in sweeps (or never)
+- Google indexing → 24–72h with Indexing API, longer organic
+- Bing indexing → hours with IndexNow, days without
+- Model training updates → unknown schedule, outside our control
+
+**Never say:** "Deploy this and re-run canonry to see if it worked."
+**Always say:** "This positions the site correctly. Canonry will tell us if/when that pays off."

package/assets/agent-workspace/skills/canonry-setup/references/canonry-cli.md

@@ -0,0 +1,349 @@
+# Canonry CLI Reference
+
+## Server Management
+
+```bash
+canonry init                                      # interactive setup
+canonry bootstrap                                 # non-interactive setup from env vars
+canonry start                                     # start daemon
+canonry stop                                      # stop daemon
+canonry serve                                     # foreground mode
+canonry serve --host 0.0.0.0 --port 4100
+canonry --version
+```
+
+Production managed by PM2:
+```bash
+pm2 status
+pm2 logs canonry
+pm2 restart canonry
+```
+
+## Project Management
+
+```bash
+canonry project list                              # list all projects
+canonry project create <name> --domain <url> --country US --language en
+canonry project show <name>                       # project detail
+canonry project update <name>                     # update project settings
+canonry project delete <name>                     # delete a project
+canonry status <project>                          # citation summary + domain info
+```
+
+### Locations
+
+Projects support multi-region location context for geographically-aware sweeps:
+
+```bash
+canonry project add-location <name> --label "NYC" --city "New York" --region NY --country US
+canonry project locations <name>                  # list configured locations
+canonry project set-default-location <name> <label>
+canonry project remove-location <name> <label>
+```
+
+## Sweeps
+
+```bash
+canonry snapshot "Acme Corp" --domain acme.example.com      # one-shot sales snapshot
+canonry snapshot "Acme Corp" --domain acme.example.com --md          # save markdown report
+canonry snapshot "Acme Corp" --domain acme.example.com --output report.md  # custom path
+canonry snapshot "Acme Corp" --domain acme.example.com --pdf         # save PDF report
+canonry snapshot "Acme Corp" --domain acme.example.com --format json
+
+canonry run <project>                             # sweep all configured providers
+canonry run <project> --provider gemini           # single provider only
+canonry run <project> --wait                      # block until complete
+canonry run <project> --location <label>          # run with specific location context
+canonry run <project> --all-locations             # run for every configured location
+canonry run <project> --no-location               # explicitly skip location context
+canonry run --all --wait                          # all projects
+canonry run cancel <project> [run-id]             # force-cancel stuck runs
+canonry runs <project> --limit 10                 # list recent runs
+canonry run show <id>                             # show run details
+```
+
+Run statuses: `queued` → `running` → `completed` / `failed` / `partial`
+
+`partial` = some providers failed (usually rate limits) — successful snapshots are still saved.
+
+`snapshot` does not create a project or write to the DB. It generates category queries, runs providers, and produces a report for prospecting.
+
+## Citation Data
+
+```bash
+canonry evidence <project>                        # per-keyword cited/not-cited
+canonry evidence <project> --format json          # JSON output
+canonry history <project>                         # audit trail
+canonry export <project> --include-results        # export as YAML
+canonry backfill answer-visibility                # recompute answer visibility from stored answers
+canonry backfill answer-visibility --project <name> --format json
+```
+
+Output shows:
+- `✓ cited` — domain appeared in AI response for that keyword
+- `✗ not-cited` — domain did not appear
+- Summary: `Cited: X / Y`
+
+## Analytics
+
+```bash
+canonry analytics <project>                       # default analytics view
+canonry analytics <project> --feature metrics     # citation rate trends
+canonry analytics <project> --feature gaps        # brand gap analysis (cited/gap/uncited)
+canonry analytics <project> --feature sources     # source breakdown by category
+canonry analytics <project> --window 7d           # time window: 7d, 30d, 90d, all
+```
+
+## Intelligence
+
+```bash
+canonry insights <project>                        # list active insights (regressions, gains, opportunities)
+canonry insights <project> --dismissed            # include dismissed insights
+canonry insights <project> --format json          # JSON output
+canonry insights dismiss <project> <id>           # dismiss an insight
+canonry health <project>                          # latest citation health snapshot
+canonry health <project> --history                # health trend over time
+canonry health <project> --history --limit 10     # limit history entries
+canonry health <project> --format json            # JSON output
+canonry backfill insights <project>              # backfill insights for all completed runs
+canonry backfill insights <project> --from-run <id> --to-run <id>  # backfill a range
+```
+
+## Keywords & Competitors
+
+```bash
+canonry keyword add <project> "phrase one" "phrase two"
+canonry keyword remove <project> "phrase"
+canonry keyword list <project>
+canonry keyword import <project> keywords.txt
+canonry keyword generate <project> --provider gemini --count 10 --save
+
+canonry competitor add <project> competitor1.com competitor2.com
+canonry competitor list <project>
+```
+
+## Scheduling & Notifications
+
+```bash
+canonry schedule set <project> --preset daily     # or: weekly, twice-daily, daily@09
+canonry schedule set <project> --cron "0 9 * * *" --timezone America/New_York
+canonry schedule show <project>
+canonry schedule enable <project>
+canonry schedule disable <project>
+canonry schedule remove <project>
+
+canonry notify add <project> --webhook <url> --events citation.lost,citation.gained
+canonry notify events                             # list all available event types
+canonry notify list <project>
+canonry notify remove <project> <id>
+canonry notify test <project> <id>
+```
+
+Available events: `citation.lost`, `citation.gained`, `run.completed`, `run.failed`, `insight.critical`, `insight.high`
+
+`insight.critical` and `insight.high` fire when the intelligence engine generates critical- or high-severity insights after a sweep completes.
+
+## Provider Settings & Quotas
+
+```bash
+canonry settings                                  # show config: providers, apiUrl, db path
+canonry settings --format json
+canonry settings provider gemini --api-key <KEY> --model gemini-2.5-flash
+canonry settings provider openai --max-per-day 1000 --max-per-minute 20
+canonry settings provider perplexity --api-key <KEY>
+```
+
+Quota flags: `--max-concurrent`, `--max-per-minute`, `--max-per-day`
+
+Available providers: `gemini`, `openai`, `claude`, `perplexity`, `local`, `cdp`
+
+If a provider hits rate limits (429 errors), the run completes as `partial`. Reduce concurrency or increase time between sweeps.
+
+### Gemini Vertex AI
+
+Gemini supports Vertex AI as an alternative to API key authentication. Use GCP Application Default Credentials (ADC) or a service account JSON key file:
+
+```bash
+# Via env vars (recommended for servers)
+export GEMINI_VERTEX_PROJECT=my-gcp-project
+export GEMINI_VERTEX_REGION=us-central1            # optional, defaults to us-central1
+export GEMINI_VERTEX_CREDENTIALS=/path/to/sa.json  # optional, falls back to ADC
+
+# Or in canonry.yaml config
+# vertexProject, vertexRegion, vertexCredentials fields under provider config
+```
+
+When Vertex AI is configured, no `GEMINI_API_KEY` is required. The provider uses the `@google-cloud/vertexai` SDK with `googleAuthOptions` for credential handling.
+
+## Google Search Console
+
+```bash
+canonry google connect <project>                          # initiate OAuth flow
+canonry google disconnect <project>                       # disconnect GSC
+canonry google status <project>                           # connection status
+canonry google properties <project>                       # list available properties
+canonry google set-property <project> <url>               # set GSC property URL
+canonry google set-sitemap <project> <url>                # set sitemap URL
+canonry google list-sitemaps <project>                    # list submitted sitemaps
+canonry google discover-sitemaps <project> --wait         # auto-discover and inspect
+
+canonry google sync <project>                             # sync GSC data
+canonry google sync <project> --days 30 --full --wait     # full sync with wait
+
+canonry google coverage <project>                         # index coverage summary
+canonry google refresh <project>                         # force-fetch fresh GSC coverage data
+canonry google performance <project>                      # search performance data
+canonry google performance <project> --days 30 --keyword "term" --page "/url"
+
+canonry google inspect <project> <url>                    # inspect specific URL
+canonry google inspect-sitemap <project> --wait           # bulk inspect all sitemap URLs
+canonry google inspections <project>                      # inspection history
+canonry google inspections <project> --url <url>          # filter by URL
+canonry google deindexed <project>                        # pages that lost indexing
+
+canonry google request-indexing <project> <url>           # push URL to Google
+canonry google request-indexing <project> --all-unindexed # push all unknown pages
+```
+
+## Bing Webmaster Tools
+
+```bash
+canonry bing connect <project> --api-key <key>   # connect Bing WMT
+canonry bing disconnect <project>                # disconnect
+canonry bing status <project>                    # connection status
+canonry bing sites <project>                     # list verified sites
+canonry bing set-site <project> <url>            # set active site URL
+canonry bing coverage <project>                  # URL coverage data
+canonry bing refresh <project>                  # force-fetch fresh Bing coverage data
+canonry bing inspect <project> <url>             # inspect specific URL
+canonry bing inspections <project>               # inspection history
+canonry bing request-indexing <project> <url>    # submit URL for indexing
+canonry bing request-indexing <project> --all-unindexed  # submit all unindexed
+canonry bing performance <project>               # search performance data
+```
+
+## WordPress Integration
+
+```bash
+canonry wordpress connect <project> --url <url> --user <user>   # connect (prompts for app password)
+canonry wordpress disconnect <project>                          # disconnect
+canonry wordpress status <project>                              # connection status
+canonry wordpress pages <project> [--live|--staging]            # list pages
+canonry wordpress page <project> <slug>                         # show page detail
+canonry wordpress create-page <project> --title <t> --slug <s> --content <c>  # create page
+canonry wordpress update-page <project> <slug> --content <c>   # update page
+canonry wordpress set-meta <project> <slug> --title <t>        # set SEO meta (single page)
+canonry wordpress set-meta <project> --from <file>              # bulk set SEO meta from JSON
+canonry wordpress schema <project> <slug>                       # read page JSON-LD
+canonry wordpress schema deploy <project> --profile <file>      # deploy schema from profile
+canonry wordpress schema status <project>                       # schema status per page
+canonry wordpress set-schema <project> <slug>                   # manual schema handoff
+canonry wordpress audit <project>                               # audit pages for SEO issues
+canonry wordpress diff <project> <slug>                         # compare live vs staging
+canonry wordpress staging status <project>                      # staging config status
+canonry wordpress staging push <project>                        # manual staging push handoff
+canonry wordpress llms-txt <project>                            # read /llms.txt
+canonry wordpress set-llms-txt <project>                        # manual llms.txt handoff
+canonry wordpress onboard <project> --url <url> --user <user>  # full onboarding workflow
+```
+
+**Onboard** runs: connect → audit → set-meta → schema deploy → Google submit → Bing submit. Use `--skip-schema` or `--skip-submit` to skip steps. `--profile <file>` provides business data and page-to-schema mapping for schema deployment.
+
+## Google Analytics 4
+
+GA4 integration uses service account authentication (no OAuth). The service account must have Viewer access on the GA4 property.
+
+```bash
+canonry ga connect <project> --property-id <id> --key-file ./sa-key.json  # connect GA4
+canonry ga disconnect <project>                  # disconnect
+canonry ga status <project>                      # connection status
+canonry ga sync <project> [--days 30] [--only traffic|ai|social]  # pull GA4 data (selective or full)
+canonry ga traffic <project>                     # landing pages + AI/social referral sources
+canonry ga coverage <project>                    # indexed pages with traffic overlay
+canonry ga ai-referral-history <project>         # daily AI referral history by source
+canonry ga social-referral-history <project>     # daily social referral history by source
+canonry ga social-referral-summary <project> [--trend]  # one-line social summary + optional trend
+canonry ga attribution <project> [--trend]        # unified channel attribution overview + optional trends
+```
+
+## CDP / Browser Provider
+
+The CDP (Chrome DevTools Protocol) provider enables browser-based queries against AI chat interfaces (e.g., ChatGPT). This gives more accurate results than API-based providers for some use cases.
+
+```bash
+canonry cdp connect --host localhost --port 9222  # connect to Chrome CDP
+canonry cdp status                                # show connection status
+canonry cdp targets                               # list available targets (ChatGPT, etc.)
+canonry cdp screenshot <query> --targets chatgpt  # screenshot a query result
+```
+
+**Requires:** Chrome running with `--remote-debugging-port=9222`
+
+## Telemetry
+
+```bash
+canonry telemetry status                          # show telemetry status
+canonry telemetry enable                          # enable anonymous telemetry
+canonry telemetry disable                         # disable telemetry
+```
+
+## Config as Code
+
+```bash
+canonry apply project.yaml                        # apply declarative config
+canonry apply file1.yaml file2.yaml               # multiple files
+canonry export <project> --include-results > project.yaml
+canonry sitemap inspect <project>
+```
+
+## Agent (OpenClaw Integration)
+
+`canonry agent setup` is the single entry point for configuring the agent. It handles everything:
+canonry initialization, OpenClaw installation, profile setup, LLM credential configuration,
+and workspace seeding. If canonry is not yet configured, it runs the interactive init flow first
+(prompting for monitoring provider keys and agent LLM credentials).
+
+```bash
+# Full setup (interactive — prompts for provider keys + agent LLM)
+canonry agent setup
+
+# Non-interactive (flags or env vars)
+canonry agent setup --gemini-key <key> --agent-key <key>
+canonry agent setup --agent-provider openrouter --agent-key <key> --agent-model openrouter/anthropic/claude-sonnet-4-6
+GEMINI_API_KEY=<key> canonry agent setup --agent-key <key> --format json
+
+# Lifecycle
+canonry agent start                              # start OpenClaw gateway as background process
+canonry agent stop                               # stop the gateway process
+canonry agent status                             # check if gateway is running
+canonry agent status --format json               # JSON output
+canonry agent reset                              # stop gateway and wipe workspace
+
+# Setup flags
+canonry agent setup --agent-provider <id>        # LLM provider (default: anthropic)
+canonry agent setup --agent-key <key>            # API key for agent LLM
+canonry agent setup --agent-model <model>        # model id (e.g. anthropic/claude-sonnet-4-6)
+canonry agent setup --gateway-port 3579          # gateway WebSocket port
+canonry agent setup --gemini-key <key>           # monitoring provider keys (passed to init)
+canonry agent setup --openai-key <key>
+canonry agent setup --claude-key <key>
+canonry agent setup --perplexity-key <key>
+
+# Webhook lifecycle
+canonry agent attach <project>                   # register agent webhook for project
+canonry agent attach <project> --format json     # JSON output
+canonry agent detach <project>                   # remove agent webhook from project
+canonry agent detach <project> --format json     # JSON output
+```
+
+**Setup flow:** init canonry (if needed) → install OpenClaw (if needed) → configure profile → configure gateway → set agent LLM credentials → seed workspace with skills.
+
+**Agent LLM credentials** are stored in `~/.openclaw-aero/.env` (e.g. `ANTHROPIC_API_KEY=...`) and loaded into the gateway process at start time. The model is set via `openclaw models set`.
+
+**Re-running is safe:** setup is idempotent — it skips steps that are already configured.
+
+**Agent webhooks:** `canonry agent attach <project>` registers a webhook notification on the project so the agent receives events (`run.completed`, `insight.critical`, `insight.high`, `citation.gained`). Idempotent — skips if an agent webhook already exists. `canonry agent detach <project>` removes the agent webhook. When `autoStart` is enabled, the server auto-attaches webhooks to newly created or applied projects.
+
+## Output Formats
+
+Most commands support `--format json` for machine-readable output.

package/assets/agent-workspace/skills/canonry-setup/references/indexing.md

@@ -0,0 +1,155 @@
+# Indexing Workflows for AEO
+
+Getting pages indexed fast is high-leverage AEO work. Unindexed pages are invisible to AI citation regardless of content quality.
+
+## Priority Order
+
+1. **Google Indexing API** — fastest path to ChatGPT/Perplexity visibility (they lean on Google)
+2. **Bing WMT + IndexNow** — fastest path to Copilot/Bing AI visibility
+3. **Sitemap submission** — baseline for both; do once on setup
+
+---
+
+## Google Search Console
+
+### Check coverage
+```bash
+canonry google coverage <project>
+```
+
+Statuses to act on:
+- `URL is unknown to Google` → highest priority, submit immediately
+- `Discovered - currently not indexed` → Google found it but hasn't crawled — submit to accelerate
+- `indexed` → no action needed
+
+### Sync GSC data
+```bash
+canonry google sync <project>                    # incremental sync
+canonry google sync <project> --full --wait      # full re-sync
+```
+
+### Check search performance
+```bash
+canonry google performance <project>                        # default 28 days
+canonry google performance <project> --days 90 --keyword "term"
+```
+
+### Discover and inspect sitemaps
+```bash
+canonry google discover-sitemaps <project> --wait   # auto-discover sitemaps and queue inspection
+canonry google list-sitemaps <project>               # list submitted sitemaps
+canonry google inspect-sitemap <project> --wait      # bulk inspect all sitemap URLs
+```
+
+### Inspect individual URLs
+```bash
+canonry google inspect <project> <url>              # inspect specific URL
+canonry google inspections <project>                # inspection history
+canonry google inspections <project> --url <url>    # filter by URL
+canonry google deindexed <project>                  # pages that lost indexing
+```
+
+### Submit URLs to Google Indexing API
+```bash
+# Single URL
+canonry google request-indexing <project> <url>
+
+# All unindexed at once
+canonry google request-indexing <project> --all-unindexed
+```
+
+**Requirements:**
+- "Web Search Indexing API" enabled in the GCP project
+- OAuth connection set up in canonry (`canonry settings` shows Google connection)
+- Officially intended for JobPosting/BroadcastEvent schema; in practice Google processes all URLs
+
+**After submitting:** Check coverage again after 48h. Once indexed, run a sweep — pages must be indexed before citation is possible.
+
+---
+
+## Bing Webmaster Tools
+
+### One-time setup
+```bash
+canonry bing connect <project> --api-key <key>
+canonry bing set-site <project> https://example.com/
+```
+
+Get API key from: https://www.bing.com/webmasters/ → Settings → API Access
+
+### Check connection and coverage
+```bash
+canonry bing status <project>
+canonry bing coverage <project>
+canonry bing performance <project>
+```
+
+### Inspect URLs
+```bash
+canonry bing inspect <project> <url>
+canonry bing inspections <project>
+```
+
+### Submit URLs for indexing
+```bash
+canonry bing request-indexing <project> <url>
+canonry bing request-indexing <project> --all-unindexed
+```
+
+### Submit sitemap (manual, one-time)
+Bing WMT → Sitemaps → submit `https://example.com/sitemap.xml`
+
+### IndexNow (instant crawl signal)
+IndexNow is a direct ping to Bing: "these URLs changed, crawl them now." Without it, Bing discovers pages on its own schedule (days to weeks). With it, typically hours.
+
+**Host the key file at the root:**
+```
+https://example.com/<key>.txt
+```
+File content: just the key string, nothing else.
+
+**Submit URLs:**
+```bash
+curl -X POST "https://www.bing.com/indexnow" \
+  -H "Content-Type: application/json; charset=utf-8" \
+  -d '{
+    "host": "example.com",
+    "key": "<key>",
+    "keyLocation": "https://example.com/<key>.txt",
+    "urlList": [
+      "https://example.com/",
+      "https://example.com/page-1"
+    ]
+  }'
+```
+
+Expected response: `202 Accepted`
+
+**Note:** IndexNow only covers Bing (and Yandex). It does NOT affect ChatGPT, Claude, or Gemini.
+
+---
+
+## When to Use What
+
+| Goal | Tool |
+|---|---|
+| Get pages into ChatGPT / Perplexity / Claude | Google Indexing API |
+| Get pages into Copilot / Bing AI | IndexNow + Bing WMT |
+| Audit what Google currently knows | `canonry google coverage <project>` |
+| Audit what Bing currently knows | `canonry bing coverage <project>` |
+| Fast crawl of new/updated pages on Bing | IndexNow batch submit |
+| Ongoing Google crawl health | `canonry google sync` + `canonry google performance` |
+| Ongoing Bing crawl health | Bing WMT sitemap + `canonry bing performance` |
+| Find deindexed pages | `canonry google deindexed <project>` |
+
+---
+
+## General Workflow for New Client Pages
+
+1. `canonry google coverage <project>` — identify unindexed pages
+2. `canonry google request-indexing <project> --all-unindexed` — push to Google
+3. `canonry bing request-indexing <project> --all-unindexed` — push to Bing
+4. Submit sitemap to Bing WMT (manual, one-time per site)
+5. Send IndexNow batch for key URLs
+6. Re-check coverage after 48h
+7. Run a sweep after pages confirmed indexed