fileforge_audit_action
Audit a page or site for SEO, content, policy, and client-side security issues; store results or compare runs to track changes.
Instructions
Audit a page or site for SEO, content, policy and client-side security issues. Prefer query_audit with a preset; compare_runs shows what changed between stored audits. Use fileforge_a11y_action, fileforge_perf_action or fileforge_responsive_action for one focused check. reveal_client_security_value needs FILEFORGE_ALLOW_SECRET_REVEAL=1. Results can be stored. Needs the extension.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Storage key whose value to reveal. | |
| ref | No | Ref of a stored result. | |
| url | No | Page URL. Omit to use the active tab where the action allows it. | |
| text | No | Page text to include in the sensitivity check. | |
| query | No | Modules to return and their options. Takes priority over preset. Modules: page, seo, accessibility, performance, conversion, visual, technical, privacyTrust, structuredData, links, assets, forms, crawl, scores, issues, roadmap, report, snapshot, summary. | |
| store | No | Save the result in ~/.fileforge and return a ref. | |
| tabId | No | Tab ID, or "active" for the active tab. | |
| title | No | Page title to include in the sensitivity check. | |
| action | Yes | What to do. Required parameters are in brackets. query_audit: Unified GraphQL-feel audit. Select audit modules (seo, accessibility, performance, conversion, visual, technical, privacyTrust, structuredData, crawl), presets, scores, issues, roadmap, report, and snapshots in one call. compare_audit_snapshots (beforeSnapshotId, afterSnapshotId): Compare two audit snapshots (by ID) and report score deltas, new issues, resolved issues, and changed modules. site_route (url): Audit site routes and links for broken routes, invalid links, duplicate titles, missing canonicals, redirects, and route health. content_consistency (url): Detect pricing, subscription, feature-count, product-identity, and limitation contradictions across crawled pages. extension_policy (url): Review site/listing/manifest copy for Chrome extension policy and claim-safety risks. client_side_security (url): Inspect client-side storage for Pro/license flags, exposed secrets, debug flags, tokens, and sensitive state with redacted evidence. reveal_client_security_value (url): Reveal one exact redacted client-storage value after an explicit scoped agent request, and log the reveal. recommendations_rank: Deduplicate and rank issues by impact, severity, confidence, project type, and affected pages. compare_runs (beforeRef, afterRef): Compare two stored audit runs for added/resolved issues and high-level performance/evidence changes. export_package (ref): Export a stored audit result as a ZIP package with report.md, issues.json, summary.json, and evidence/result.json. summary (ref): Return a stored audit result in an agent-friendly summary mode such as developer, seo, compliance, conversion, detailed, short, or json-only. sensitive_session_check (url): Classify whether a URL appears sensitive/private before deep authenticated-page scraping. | |
| issues | No | Issues to rank. | |
| preset | No | Named set of query modules. | |
| routes | No | Route paths to visit, such as "/pricing". | |
| target | No | What to audit: { url } or { tabId }. Defaults to the active tab. | |
| project | No | Project name that groups stored results. | default |
| afterRef | No | Ref of the later stored result. | |
| crawlRef | No | Ref of a stored crawl to reuse. | |
| filename | No | Output filename. | |
| location | No | Exact location returned by the audit. | |
| manifest | No | Extension manifest to check. | |
| maxPages | No | Maximum pages to visit. | |
| beforeRef | No | Ref of the earlier stored result. | |
| maxChecks | No | Maximum checks to run. | |
| namespace | No | Web storage area that holds the value. | |
| listingCopy | No | Store listing text to check. | |
| projectType | No | Project type used to rank issues. | generic |
| summaryMode | No | Summary length. | short |
| afterSnapshotId | No | ID of the later snapshot. | |
| beforeSnapshotId | No | ID of the earlier snapshot. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | False if the action failed or a check did not pass. | |
| ref | No | Stored result ID, for fileforge_result_action. | |
| data | No | The result. Its shape depends on the action. | |
| meta | No | Tool, action and context. | |
| error | No | Failure code and message. | |
| warnings | No | Notes about a call that still ran. |