Convertlyft

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 paid-work limit in credits, the credit balance (owner or billing seat), new public scans left today, and which tools each missing scope blocks. Call this first when a tool refuses you — the answer usually says what to change.

Where people got stuck in a window: the pages people spend time on and scroll through, the rage clicks, the dead clicks (the tag’s own, minus the ones a link or a call answered — the Stuck spots page’s count), and the form start-vs-submit funnel. Rows carry the same field names as cvl_dead_clicks, cvl_rage_clicks, cvl_page_attention and cvl_form_friction. Every collection is always present — an em

Visitors, visits, the share of visits that bought or got in touch (conversion rate), revenue by currency, median engaged time and site health for a window — the same figures, from the same code, as the dashboard header. Every figure is an object, never a bare number: read "state" first. When state is "ok" it carries "value", a rendered "display", and its own "previous" and "delta" so you never div

The methodology behind one figure on the KPI header: its definition, the population it was computed over (denominator, numerator and row count), the filters in force, the condition that decides when it is withheld rather than shown, and the attribution epoch before which campaign-filtered counts are undercounted. It returns no figure value — call cvl_kpi for that, and present the same window.handl

Submit the sentence you are about to say plus the evidence ids (receipt_ids) of the data you were given. Returns ok, or the exact span no evidence supports for the figure your sentence names, and a corrected sentence. A numeral is checked against the figure you NAME, so "Visitors were 41" is refused when visitors are 45 and 41 is the visit count — a real number on the wrong figure is the failure t

Show exactly what cvl_change_apply would write, and the undo it would hand back, without writing anything. Nothing is queued and nothing is stored by this call. Returns the preview_token cvl_change_apply needs for this same change (valid 30 minutes).

Record that the site changed, so the impact can be measured against it. Needs the preview_token from cvl_change_preview of the same note and marked_at: preview, show the person, apply only after they agree. Retry with the same idempotency_key and you get the same single marker back — never a second one. Returns the proposal id you undo with.

Remove a marker you wrote, using the undo computed when it was applied. Takes the proposal_id cvl_change_apply returned. Calling it twice is safe — the second call reports the same result and removes nothing.

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 t

Queue a fix for the OWNER to approve. This does not apply anything and cannot: approval is a human act on this product, and no credential can approve a proposal, including its own. baseline is what you saw before proposing and revert_plan is how to undo it — both are required, because a proposal that cannot be staleness-checked or undone is one an owner cannot safely accept. Proposing the same fix

Queue today’s operator run for this workspace. It does NOT execute here — a worker claims the row and runs it, so this returns a run id and a status, never a report. If the workspace has already spent its daily cap the call is refused and names the cap and the spend; asking twice on one day attaches to the existing row rather than starting a second run.

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 uses the account’s credits, 1 per crawled page, so at most max_pages credits (dry_run: true says so and buys nothing; confirm_cost caps it). It starts immediately and runs for a few minutes; the SEO tab

Tell Convertlyft that the fix for one error is live on the site. Call it only once the change is deployed — not when it is written or merged. It starts the clock on "stayed fixed": once the affected pages have had enough page loads that the old rate would have produced at least 3 of these errors and none came, the error reads as stayed fixed. The earliest report wins; reporting again changes nothi

Start a crawl of any public website with the Convertlyft crawler and get a crawl_id straight away; the crawl runs for a few minutes. It uses the account’s credits: 1 per crawled page, charged when the crawl ends and never more than limit; the answer gives max_credits, the balance and the balance after the most it can cost. It obeys the site’s robots.txt, skips sign-in endpoints (/api/auth/*), neve

Add searches to rank tracking in a market. Checks follow the market's existing schedule; plan limits apply. Idempotent.

Remove searches from rank tracking in a market. Idempotent.

Pin a competitor (always used), dismiss one (hidden 180 days, or until it shares twice as many money keywords), or clear the choice. An authority site cannot be pinned. Idempotent.

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

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. Idempotent.

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

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.

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

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

Run the SEO chain again from the newest crawl (or from one step): keywords, competitors, SEO to-dos (the opportunities step) and briefs. It buys search data with the account’s credits inside the daily limit, with no per-call confirmation, and starts at once; cvl_seo_flow follows it. A step that meets the limit waits for tomorrow. cvl_usage shows what was used. Estimated at most 3300 credits for ea

Write a new page title, meta description or main heading for one page that has a Site audit issue words can fix (missing, too long, too short or duplicate title, meta description or H1). Written from the page's own words as the newest crawl read it, checked against them, and saved as a draft (cvl_seo_drafts). Other issues are refused with how to fix them. It buys one model pass with the account's

Make the competitor page brief for one search: it reads the live top results, crawls the top pages and writes suggestions. It buys search data and a model pass with the account’s credits inside the 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. Estimated at most 330 credits per brief made (one live sear

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) with the account’s credits; the primary market does not change. Nothing is bought when it is added. dry_run: true answers the estimated credits a check and a month, and when the first check runs, without adding anything —

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 chec

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 de

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

Search Convertlyft’s public documentation for agents — https://convertlyft.com/llms.txt and https://convertlyft.com/llms-full.txt (the API, the MCP door, dates, limits, worked examples). Returns the best-matching sections, quoted, each with where it came from. Plain word matching, not a summary. No account needed; same per-address limits as the other public tools.

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. E

Searches around one seed: ideas in the same topic (mode ideas, the default), searches that contain the seed (suggestions), or what Google lists beside it (related) — each with monthly volume, difficulty, cost per click and intent as the provider estimates them. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so ask

For searches you name: monthly volume, difficulty, intent and the last 12 months of volume, as the provider estimates them. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used. Estimated at most 450 credits per a

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. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what w

The searches one competitor ranks for that the site does not, best competitor positions first, with monthly volume and the competitor’s ranking page. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used. Estimated

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. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used.

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. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used. Estimat

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. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question

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

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

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_r

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 ta

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 wheth

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 c

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

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.

Run a Convertlyft READ tool that is not in your tool list, by name, with its arguments. It answers exactly as calling that tool directly would, with the same permissions. It refuses every write or spend tool: those are in your list and are called directly. Use cvl_search_tools to find the name and arguments.

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.

One Convertlyft skill, in full: its SKILL.md, or one of its reference files when the skill points to one. cvl_skills_list names them.