Convertlyft

What the scan found about AI agents on a public site: its agent-readiness level (L0 unreachable to L4 agent-native) with what holds it there, each AI crawler or assistant robots.txt lets in or not and what our request in its name got, whether llms.txt exists, and report_url — the full view on convertlyft.com/agent-readiness. Reads the same crawl as cvl_public_seo_scan, never a second one: pass the scan_id you already have, or a url (which starts or reuses that scan). Waits up to about 45 seconds. No account needed. Without one, the limits per address are 20 calls a minute and 200 a day, and 10…

Scan a public website for SEO problems with the Convertlyft crawler: up to 16 pages, robots.txt obeyed, no JavaScript run, nothing changed on the site. Waits up to about 45 seconds and returns the crawler's own summary: the score out of 100 with its four parts, how many critical issues, warnings and notes, the top 3 issues with up to 3 example pages each, the first fix, what this scan did not check, what AI agents could reach, and report_url — the full result on convertlyft.com/seo-audit. If the scan is still running at 45 seconds it returns {status: "running", scan_id}; call cvl_public_seo_sc…

The result of a scan cvl_public_seo_scan started, by its scan_id. Same shape as that tool's answer; waits up to about 45 seconds if the scan is still running, then returns {status: "running", scan_id} again. Does not start a scan and does not count against the 5 scans a day. A scan_id stays readable for at least 24 hours (a finished scan of the same site is reused for 24 hours); the crawler may delete scans older than 30 days.

Append one row to this workspace’s ledger so the next conversation does not derive it again. A claim about the data (kind "finding") MUST carry the receipt_id (the evidence id) of the call it came from and the window it covers — a claim with no evidence behind it is refused, by design. A decision, preference or question needs no evidence. You cannot delete anything here; only the owner can, from their settings.

Remove one of the owner’s page type rules (its id from cvl_page_type_rules). A PREVIEW unless the call says dry_run:false: without it nothing changes, and the answer says how many pages it holds and what each would go back to — the type another of your rules gives it, or the status it had without your rule — with up to 10 examples. Show the owner and apply only on their yes in the chat, with dry_run:false. Applied, those pages go back, and undo is the exact call that brings back your rule and its pages. It changes how pages are grouped in reports; it changes nothing on the site.

Start a crawl of this workspace’s own site with the Convertlyft spider: every page’s status, title, description, headings, words and technical issues. A first-party crawler, not a paid provider; it counts toward the plan’s “Pages scanned”, at most max_pages (dry_run: true says how many pages are left and checks nothing). It starts immediately and runs for a few minutes; the SEO tab follows it live, and cvl_site_pages / cvl_page_content read it once it has finished. Use it when the person asks for a crawl or an audit, or when they ask about their pages and no crawl exists yet.

Find a Convertlyft tool that is not in your tool list, and the skills (step-by-step playbooks) that fit. Your list holds a core set; behaviour, SEO, errors, site and workspace reads are here. Answers name, title and one line per tool; schema:true adds the input schema. Run a read it finds with cvl_call_read. Writes are always in your list already: call them directly.

Add searches to the keyword list, optionally for one page. Idempotent.

Start tracking this site in another market (country, language and device). The new market copies the primary market’s tracked searches and is checked weekly (Mondays, 02:00 UTC); its checks are included in the plan and count toward keywords tracked; the primary market does not change. Nothing is bought when it is added. dry_run: true answers what would be added and when the first check runs, without adding anything. A market already tracked is refused.

Whether AI assistants name a site: answers from the provider’s tracked panel of prompts, each with the platform, the question, whether the site was mentioned and an excerpt. A sample of tracked answers, not every answer an assistant gives. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit…

The latest full crawl of this site as a summary (a newer list re-check, a 0-page run or a crawl still running never replaces it; full_run names it then, and a re-check clears what it no longer finds): the run (run_id, status, pages crawled), the issues it found in lanes (you_fix, developer, not_a_problem), counted by severity and listed by id with how many pages each touches, the ten pages people land on most over four weeks of measured visits, the crawl-over-crawl changes and past runs. One issue in full — its fix text and sample pages — with issue: "<id>". Page rows a page at a time with lim…

Any site’s backlink headline counts from the provider’s link index: referring domains, backlinks, broken backlinks, referring pages and when it was first seen. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

How many domains and pages link to this site, snapshot by snapshot, and the newest link-gap read: domains linking to chosen rivals but not here. Served from stored pulls.

Decide the searches listed under a stored SEO content brief’s "Keywords to add" — add, skip, or clear, several at once (the room’s "Add all"). Name the brief by its own search. Idempotent.

Check where this site ranks in the top 10 right now for one tracked search (keyword), or for every search a market tracks. Free, once a day per search: a search already checked today is not checked again and the answer says so. It starts at once and does not wait; the positions land on cvl_seo_rank within minutes. Only searches the market tracks can be checked (cvl_seo_track_keywords adds one). Omit market for the primary market.

The searches one competitor ranks for that the site does not, best competitor positions first, with monthly volume and the competitor’s ranking page. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Any site’s organic footprint in one country: how many searches it ranks for, how many of those in the top 3, and the provider’s estimate of its monthly search traffic. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Draft a page for one search with Convertlyft’s own writer: the same path as Generate brief then Send to Drafts in the SEO room. It reads the top results, makes the SEO content brief (one of the month’s, counted once it is Ready; a rebuild of one already counted this month is free) and writes the page from your site’s own words; a claim your site never makes becomes a [Fill in: …] gap for you. It does not wait: it answers at once with brief_id, status and poll_after_s; follow it with cvl_seo_draft_status. A brief made in the last 7 days is reused unless force is true; when it is Ready this save…

Say a page draft is live: the SEO room’s Mark published. Name it by draft_id (from cvl_seo_drafts or cvl_seo_draft); url is where it went live, on this site’s own domain (omit to keep the address it has, or its page’s). The draft leaves the Drafts count. A draft for a page that already exists closes its SEO to-do and its brief now; a draft for a new page closes them once a crawl finds the page live with the draft’s title and H1 (a finished crawl also publishes such a draft by itself, published_via crawl). Idempotent: the same call again changes nothing (changed: false). A draft this site does …

Where the automatic SEO chain stands for this site: crawl, keywords, competitors, SEO to-dos (the opportunities step) and briefs, each done / running / waiting for the daily limit / failed with its reason, plus counts, and a search_console step (done, waiting, or not-connected). briefs is running while any brief is still being made. run_id is the spider run the chain worked from — the run_id cvl_site_pages and cvl_page_content name. Read from stored rows.

Say a Site audit issue is not a problem on this site (a redirect you put there, a page kept out of Google on purpose): it stops counting and is listed under Not a problem. With page, on that one page only: the issue still counts on its other pages, so a deliberate noindex on /demo never hides an accidental one on the homepage. not_a_problem: false counts it again. A preview unless dry_run: false: show the owner, apply on their yes. Idempotent.

Renamed cvl_seo_issue_not_a_problem, which does the same; this name keeps working until 2026-11-18. Say a Site audit issue is deliberate on this site (a redirect you put there, a page kept out of Google on purpose): it stops counting and is listed as on purpose. on_purpose: false counts it again. A preview unless dry_run: false. Idempotent.

Searches around one seed: searches that contain the seed (mode suggestions, the default: stays on the seed), what Google lists beside it (related), or the provider’s ideas in the same topic (ideas: wider, and often off-topic for a short seed) — each with monthly volume, difficulty, cost per click and intent as the provider estimates them. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the…

For searches you name: monthly volume, difficulty, intent and the last 12 months of volume, as the provider estimates them. Every search named gets a row; one the provider holds nothing for has null figures and a reason. A list longer than `limit` is answered a page at a time: `remaining` counts the rest and `next` asks for them. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, in…

Referring domains that link to one or more of the named competitors and not to the site, with which competitors each links to, its spam score and rank. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Make the SEO content brief for one search: it reads the live top results, crawls the top pages and writes suggestions. It uses one of the month’s SEO content briefs (refilled on the 1st), inside this site’s daily limit, with no per-call confirmation. A brief made in the last 7 days is returned as it is unless force is true. cvl_seo_brief reads it. dry_run: true gives, without making it, how much of today’s limit is used (rounded) and whether it fits (fits_today); nothing is charged per call.

Say which page of the site targets a search. Answers the page it had before.

The ranked to-do list: searches your competitors win and you do not, related searches around your money keywords, and Search Console near-misses (position 8–30, ≥10 impressions in 28 days) — each mapped to a page (page_url, null for a new page) with one action (improve / create / track), the reason, the evidence date and its brief. priority is the stored score; dots is that score as 1–5 relative to the top row on this page, for display only. briefStatus is the brief for that search: null (none), queued, crawling, ready or failed; briefOpened says whether someone has opened it.

Act on an SEO to-do from cvl_seo_opportunities by tracking its search. Idempotent.

The searches any site ranks for in the top 30 in one country, as the provider’s index holds them, biggest search first: each with the position, the ranking page, and monthly volume, difficulty and intent as the provider estimates them. For this site’s own searches as Google reports them, cvl_seo_search_console (free) is the measured read; this one also works for a competitor or a site with no Search Console. Empty rows with a reason when the provider holds nothing for the domain. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmatio…

Run the SEO chain again from the newest crawl (or from one step): keywords, competitors, SEO to-dos and SEO content briefs. Search data is included in the plan, inside this site’s daily limit, with no per-call confirmation; each new brief uses one of the month’s SEO content briefs. It starts at once; cvl_seo_flow follows it. A step that meets the limit waits for tomorrow. cvl_usage shows what was used. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether it fits (fits_today); nothing is charged per call.

The live first page of Google results for one search in one country: position, address, domain and title of each organic result, the "People also ask" questions, and every other block the page held — ads, AI overview, map pack, video and the rest — as features, typed by the provider. Ads and other blocks take places, so the first page can hold fewer than 10 organic results; organic_note says so. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true b…

Pin a competitor (always used), hide one (state hidden, or its older name dismissed: hidden 180 days, or until it shares twice as many money keywords), or clear the choice. An authority site cannot be pinned. Idempotent. dry_run: true changes nothing and answers the competitors allowance a pin would use (before, after, fits) and why it would be refused, if it would.

Mark a search as a money keyword (counts for competitors and SEO to-dos) or not. The same call with the other value undoes it.

Submit one sitemap to Google Search Console for this site. A preview by default: without confirm: true it answers what would be sent and whether the connection may send it, and sends nothing — show that to the owner and submit only once they agree. With confirm: true it submits, answers the sitemap’s state and a next hint to re-check it later with cvl_seo_sitemaps; Google reads a submitted sitemap on its own schedule. Submitting does not put pages on Google by itself. feedpath defaults to /sitemap.xml at the site. needs_write_access means the connection was granted read-only access: the owner …

Add searches to rank tracking in a market. Checks follow the market's existing schedule; plan limits apply. Idempotent. dry_run: true tracks nothing and answers the tracked-keywords allowance it would use (before, after, fits) and why it would be refused, if it would.

Remove searches from rank tracking in a market. Idempotent.

Retired 2026-10-18 and no longer offered: every call answers not_offered and spends nothing. It leaves the list on 2026-11-17. For a title, meta description or H1 issue, cvl_seo_audit says how to fix it.

Choose which visits this site records. every_visit (the default): every visit is recorded from its first page, bounces included. problems_only: a visit is recorded only when it matters — a JavaScript error, a rage or dead click, a form left, or a key page such as checkout, cart, contact or sign-up — and then from its start, the lead-up included. A preview by default: without confirm: true it answers the choice that would be saved and saves nothing — show that to the owner and save only once they agree. With confirm: true it saves; the site uses it from its next page view. Called with no captur…

Set the meaning of events this site sends (their names from cvl_event_meanings, at most 50), or put them back to the estimate with back_to_estimate:true. A PREVIEW unless the call says dry_run:false: without it nothing changes, and the answer says how many events would change, how many are kept as they are because a person confirmed them (kept_confirmed: this app never overwrites the owner’s or a teammate’s own confirmation), how many are already so, and the sentence to show the owner. Show the owner that preview and apply only on their yes in the chat, with the same arguments and dry_run:fals…

Set the purpose of forms of this site (their ids from cvl_forms, at most 50), or put them back to the estimate with back_to_estimate:true. A PREVIEW unless the call says dry_run:false: without it nothing changes, and the answer says how many forms would change, how many are kept as they are because a person confirmed them (kept_confirmed: this app never overwrites the owner’s or a teammate’s own confirmation), how many are already so, and the sentence to show the owner. Show the owner that preview and apply only on their yes in the chat, with the same arguments and dry_run:false. Applied, each…

Set the page type of pages of this site: up to 100 pages by address, or every page under a folder or built like one page (a page type rule of the owner’s). A PREVIEW unless the call says dry_run:false: without it nothing changes, and the answer says what would — how many pages would change, how many are kept as they are because a person confirmed them (kept_confirmed: this app never overwrites the owner’s or a teammate’s own confirmation; with a folder or like a page, a page an app confirmed on its own is kept too), how many are already so, up to 10 example pages with their status and type now…

Set which pages of this site the tag masks or skips. mask_paths: on a matching page the address is reported as the pattern itself (e.g. /account/*), in events and in recordings, and the page title is withheld, so the page still counts but its own address never leaves the visitor’s browser; what is on the page is still recorded. A page in both lists is skipped. skip_paths: on a matching page the tag does nothing at all — no events, no recording. A preview by default: without confirm: true it answers the lists that would be saved and, for each pattern, how many of the site’s known pages it match…

Set what kind of site this is: shop (sells products), service (a business offering services), lead_gen (a business whose site is there to get enquiries), saas (software people sign up for) or content (articles to read). cvl_page_types gives the type now in summary.site_type. A PREVIEW unless the call says dry_run:false: without it nothing changes, and the answer says what the type is now and whether this would change it. Show the owner and apply only on their yes in the chat, with dry_run:false. Applied, the type is Confirmed — shown in the room as set by this app — and it changes how reports …

Every page the newest crawl found, one row each: path, status, title, H1, meta description, word count, how many technical issues it has and the worst of them, and whether it is indexable. This is the reading for "what is on my site", "which pages are thin", "which pages have no description", and the list to pick a page from before reading it with cvl_page_content. Rows are the spider’s own; nothing here is computed. Paged: limit rows at a time, truncated says more exist, next_cursor fetches them. Never more rows than the crawl’s page limit. Refuses when the site has never been crawled and nam…

One Convertlyft skill, in full: its SKILL.md, or one of its reference files when the skill points to one, or one playbook section by its id (a to-do names its section as skill#PB-…). unlisted_reads: the reads the text names that the default tools/list leaves out and this credential can run; run each with cvl_call_read {name, arguments}. cvl_skills_list names them.

The Convertlyft skills: step-by-step playbooks for jobs like spotting where people get stuck, fixing errors, auditing SEO or diagnosing a drop. Each has a name and when to use it; cvl_skill_read opens one.

Add a to-do: the owner's own to-do, in What to do beside the ones the checks found (area tasks, To do). title is what needs doing, in a sentence of at most 300 characters. A PREVIEW unless the call says dry_run:false: without it nothing is written. Show the owner that preview and add it only on their yes in the chat, with the same title and dry_run:false. Applied, the answer gives the new to-do; mark it with cvl_todo_mark like any other. It changes nothing on the site.

The owner's answer to one to-do: later (Later: hidden for snooze_days, 7 by default, at most 90, then back in To do), not_a_problem (Not a problem: hidden, and the check that found it stops raising it), fix_claimed (Fixed — checking: in Fixed until the next check — it becomes Confirmed fixed when the check no longer finds it, Came back if it does again), or to_do (Back to To do). It never marks one Confirmed fixed or Came back: only the checks do. A PREVIEW unless the call says dry_run:false: without it nothing changes, and the answer says the state now and the state it would move to. Show the…

The site's to-dos: one row per problem or chance this site's checks found, kept across runs with the owner's answer. One tab at a time — to_do, good_news, fixed, hidden (To do, Good news, Fixed: Fixed — checking and Confirmed fixed, Hidden: Later and Not a problem). In To do and Good news the broken ones come first, then the most at stake; at most 20 are open at once. counts gives every tab's size. checks_delayed true means a check did not run last time (delayed_sources names which), so the list shows what it last knew — say so. area narrows to one part of the site (urgent, errors, tasks, seo,…

What this credential is, which workspace it reads, the scopes it holds, when it expires, and how many calls are left in the current windows; today’s limit for paid search data, new public scans left today, and which tools each missing scope blocks, and which skills name a tool it cannot call. The month’s allowances are in cvl_usage. Call this first when a tool refuses you — the answer usually says what to change.