Connect PageVitals to your AI agent
PageVitals provides website performance monitoring, synthetic testing, real-user monitoring reports, performance budgets, and optimization insights.
We set up the connection using your own PageVitals account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
Actions
What your agent can do in PageVitals
Each one is a real action the agent can take on its own, the same things a person clicking around PageVitals could do. Read-only by default; write actions are confirmed against your policy.
- Add Configured Pages Add one or more explicitly supplied pages to PageVitals monitoring for a website. This persistent bulk operation can consume monitored-page quota and cause future synthetic tests, so call it only when the user explicitl…
- Create Budget Create a persistent PageVitals performance budget for a website. This changes monitoring and may change owner alerting behavior, so call only when the user explicitly requests the budget and supplies the complete metric…
- Create Multistep Test Create an empty PageVitals multistep test definition with an explicit name and device profile. This only saves persistent configuration: it does not run the test, trigger any synthetic checks, or consume test-run quota.
- Create Website Add a domain to the PageVitals account and begin managing it. This may consume website quota and start monitoring, so call only when the user explicitly asks to add the domain.
- Delete Budget Delete one PageVitals performance budget and stop enforcing its threshold. This is a destructive alerting mutation; use only when the user explicitly selects the exact budget ID for deletion.
- Delete Configured Page Permanently delete one PageVitals configured page and all of its test results, including historical results. This is irreversible; use only for an explicit request naming the exact website ID and configured-page ID.
- Delete Multistep Test Permanently delete one PageVitals multistep test definition. This is irreversible; use only when the user explicitly identifies the exact website ID and test ID.
- Delete Website Permanently delete one PageVitals website and all of its tests, metrics, analytics, and configuration. This is irreversible; use only for an explicit request naming the exact website ID.
- Get Multistep Test Get one multistep test definition, including its configured steps.
- Get Page Metrics Get the latest Lighthouse and Chrome UX metrics for one configured page and device.
- Get Page Opportunities List Lighthouse improvement opportunities for a page/device, or return the full variable-shape details for one opportunity ID.
- Get Page Timeline Get one historical timeline for a page/device: combined loading metrics, CrUX, network bytes, CPU time, or Google Search performance. Google Search requires that integration on the website.
- Get Test Get the detailed Lighthouse, timing, resource, budget, and validation summary for one synthetic test. Provider values, nulls, metric scales, and JSON-looking strings are returned unchanged.
- Get Test Report Get one specialized synthetic-test report: keyed Lighthouse opportunities, the request waterfall, or grouped HTML validation findings. Validation always omits the embedded raw HTML.
- Get Test Series Get one synthetic test series and its individual tests, statuses, page IDs, device variants, and failure messages.
- List Budgets List performance budgets, current status, notification settings, and affected pages for a website.
- List Configured Pages List the raw pages configured for PageVitals monitoring on a website.
- List Multistep Runs List historical runs for one multistep test, including status, duration, interaction, layout-shift, CPU, transfer-size, and blocking-time metrics.
- List Multistep Tests List multistep tests configured for a website with recent metrics, state, and success rates. A website with no configured multistep tests returns an empty tests list.
- List Page Metrics List every configured page/device combination for a website with recent timeline and latest performance metrics.
- List Test Series List recent synthetic test series for a website, including status and failure counts.
- List Website Opportunities List Lighthouse improvement opportunities aggregated across a website and the affected pages.
- List Websites List websites visible to the connected PageVitals API key. Use the returned website IDs with all website-scoped tools.
- Run Multistep Tests Trigger exactly one named multistep test or intentionally fan out to every multistep test configured for a website. Every triggered run consumes PageVitals test quota and may incur cost. Choosing target='all' can start…
- Run Test Series Trigger synthetic tests for selected page/device variants, or for every configured test when pages is omitted. This action consumes PageVitals test quota and may incur cost; call it only when the user explicitly request…
- Update Budget Replace a PageVitals performance budget's complete metric threshold and device scope. This may change monitoring alerts or notifications. Read the current budget first, use its exact website and budget IDs, and provide…
- Update Configured Page Update a configured PageVitals page's URL, display alias, or both. This changes persistent monitoring configuration; use the exact page ID from List Configured Pages and provide at least one new value.
- Update Multistep Test Update a multistep test's alias and device. Both fields are required because PageVitals PUT replacement and partial-update semantics were not safely live-tested; read the current test first when preserving either value.
Setup
How we connect it
- 1
Connect your account
You create a key in PageVitals, a key you create and control, and paste it in once. It lives in a secrets store on your server, not with us.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
PageVitals questions, answered.
With a key you create and control. You paste it in once, it is stored in a secrets store on your server, permissions are scoped to the minimum the agent needs, and you can revoke it at any time.
The actions PageVitals's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.
Ready to put PageVitals to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by PageVitals.