Core Web Vitals
Commands and options for core web vitals.
audit-web-vitals-status
Read Core Web Vitals availability, score and score delta.
semrush audit-web-vitals-status --helpMCP tool: audit_web_vitals_status.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. |
audit-web-vitals-overview
Read native Core Web Vitals score and dated page-status counts.
semrush audit-web-vitals-overview --helpMCP tool: audit_web_vitals_overview.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. |
audit-web-vitals-pages
Read all measured URLs and their native LCP, TBT and CLS values. Retains signed URL IDs as strings.
semrush audit-web-vitals-pages --helpMCP tool: audit_web_vitals_pages.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. |
audit-web-vitals-history
Read native metric history for one exact signed URL ID.
semrush audit-web-vitals-history --helpMCP tool: audit_web_vitals_history.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. | |
--url-id | string | Required. Exact signed decimal urlId from audit-web-vitals-pages. Keep it as a string, including a leading minus sign. |
audit-web-vitals-recommendations
Read native Lighthouse recommendations for one exact signed URL ID.
semrush audit-web-vitals-recommendations --helpMCP tool: audit_web_vitals_recommendations.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. | |
--url-id | string | Required. Exact signed decimal urlId from audit-web-vitals-pages. Keep it as a string, including a leading minus sign. |
audit-web-vitals-improvements
Read native top improvements and affected-page statistics.
semrush audit-web-vitals-improvements --helpMCP tool: audit_web_vitals_improvements.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. |
audit-web-vitals-settings
Read the saved Core Web Vitals URL selection and pending-change flag.
semrush audit-web-vitals-settings --helpMCP tool: audit_web_vitals_settings.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. |
audit-web-vitals-settings-set
Replace the complete Core Web Vitals URL list for the next audit. Requires one to ten URLs; the native API rejects empty lists. Does not launch a crawl; partial acceptance requires inspecting the saved list before another write.
semrush audit-web-vitals-settings-set --helpMCP tool: audit_web_vitals_settings_set.
Use --confirm to send the change or --dry-run to preview it.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. | |
--urls | array | Required. One to ten unique absolute HTTP(S) URLs. Replaces the full saved selection. | |
--confirm | boolean | false | |
--dry-run | boolean | false |
audit-web-vitals-pdf
Generate the native Core Web Vitals PDF from an existing Site Audit and save its Essential report in My Reports. Uses reporting allowance; no crawl, email or schedule.
semrush audit-web-vitals-pdf --helpMCP tool: audit_web_vitals_pdf.
Use --confirm to send the change or --dry-run to preview it.
Pass --output <path> to save the file. Existing files are not overwritten. MCP returns an artifact resource.
| Option | Type | Default | Description |
|---|---|---|---|
--campaign-id | integer | Required. SEO project/campaign ID from project-enable-seo, not the folder ID. | |
--confirm | boolean | false | Confirm report creation, privacy acceptance and PDF generation. |
--dry-run | boolean | false | Preview the export without account access. |
--ai-summary | boolean | false | Include the native AI Summary widget. Uses your account AI summary allowance. |