內容簡介
SiteAgent for Aura 將每個 WordPress 網站轉變為可由 AI 代理安全操作的系統，提供更新、維護、審核和修復功能。透過 Aura 的連接，所有變更需經人類批准，並完整記錄審計過程，確保安全性與可追溯性。
【主要功能】
• 監控網站健康狀態
• 遠端更新外掛、佈景主題及核心
• 安全的批次更新及自動回滾
• 每個外掛的回滾功能
• 批次翻譯及資料庫升級
• 一鍵連接 Aura
外掛標籤
開發者團隊
原文外掛簡介
SiteAgent turns every WordPress site into one an AI agent can safely operate — update, maintain, audit, and fix. Once the site is connected to Aura and its approval key is provisioned, mutating actions are gated behind human approval and recorded in a full audit trail; safe batch updates and block edits are snapshotted so they can be rolled back. It’s the on-site half of Aura, the governed control room agencies use to run whole fleets of client sites alongside their servers, CDN, and DNS.
Plugin and core updates are the riskiest thing you do on a live client site. SiteAgent makes them safer: safe batch updates run behind health checks and roll back automatically if the site breaks, and every plugin in that path is zip-snapshotted first. With Aura’s approval key in place, an agent can’t silently push a change — mutating actions wait for a human to approve them. Think of it as the undo button for AI on your clients’ sites.
Install this plugin on any WordPress site to connect it to Aura — no SSH, no wp-admin juggling, no manual logins.
What You Can Do
Monitor site health — See WordPress version, PHP version, installed plugins & themes, database info, and disk usage in real time.
Update plugins, themes & core remotely — Push updates to any connected site from the Aura dashboard, no wp-admin login.
Safe batch updates with auto-rollback — Run chunked updates with health checks; if an update breaks the site, the plugin restores the previous version automatically.
Per-plugin rollback — Every update is zip-snapshotted first; restore any plugin to its last good state on demand.
Bulk translation & database upgrades — Update all language packs and run WordPress database migrations remotely.
One-click connect (magic link) — Connect a site to Aura straight from wp-admin — no manual token copy/paste.
AI-agent ready (21 MCP tools) — Exposes machine-readable, JSON-schema tools for AI-driven management, including SEO/accessibility/performance/broken-link auditors, on-site SEO-meta read/write (Rank Math, Yoast, SEOPress), and Gutenberg block read/edit. Read tools run on demand; mutating tools are approval-gated through Aura, and every call is audited.
Zero frontend impact — The plugin only registers REST API endpoints. No scripts, no styles, no database queries on visitor-facing page loads.
How It Works
After activation, click Connect to Aura on the Settings → SiteAgent page for a one-click magic-link connection, or copy the Site Token shown once and paste it into your Aura dashboard manually. From that point, Aura communicates with your site over a signed, authenticated REST API to pull health data and push updates.
Security
Defence-in-depth protects every request:
WordPress Application Password — Standard WordPress auth with capability checks (manage_options / update_*). Only authorized administrators can trigger actions.
Hashed Site Token — A per-site token sent via the X-Aura-Token header. Only a SHA-256 hash is stored (never the raw token), compared timing-safely. Tokens from older versions migrate to a hash automatically.
Brute-force throttling — Repeated bad-token attempts from an IP are blocked.
Signed magic-link connect — The onboarding callback is HMAC-signed with a one-time secret and timestamp, so the token exchange can’t be hijacked or replayed.
IP / Domain allowlist (optional) — Restrict API access to your Aura instance, with Cloudflare and reverse-proxy header support.
You can rotate the token anytime from Settings → SiteAgent → Regenerate Token.
REST API Endpoints
Core endpoints under /wp-json/aura/v1/:
GET /status — Full site health report
GET /updates — Check available updates (core, plugins, themes, translations)
POST /update/core / /update/plugin / /update/theme / /update/translations — Apply updates
POST /update/database — Run WordPress database upgrades
POST /connect — Magic-link token exchange (public, HMAC-signed, 10-minute expiry)
Version 2 endpoints under /wp-json/aura/v2/:
GET /health — HTTP, PHP fatal, white-screen and DB connectivity checks
POST /update/batch — Chunked batch updates with auto-rollback on health failure
POST /rollback/{plugin} — Restore a plugin from its most recent backup
MCP tools under /wp-json/aura/mcp/:
POST /tools/list / POST /tools/execute — Enumerate and run AI-agent tools
GET /context — Full site context for AI decision-making
AI Agent Tools (MCP)
SiteAgent ships 21 built-in tools for AI agents. Read tools return information and run on demand; write tools change the site and are queued for human approval through Aura — an agent can never silently mutate a production site.
Read tools:
get_site_context — WordPress/PHP/theme/plugin/disk/performance snapshot with detected issues
get_database_info — Database size, largest tables, autoloaded-options weight, expired transients
scan_security — Scored security posture (file-edit lockdown, debug exposure, SSL, default admin/prefix, open registration, PHP version)
scan_seo — SEO posture (search-engine visibility, permalinks, XML sitemap, site title) plus a sampled content audit (thin content, missing excerpts/featured images)
scan_a11y — Accessibility audit over sampled content (images missing alt text, non-descriptive link text, heading structure, document language)
perf_check — Performance posture (persistent object cache, OPcache, page-cache plugin, PHP version, autoload weight, active plugin count, memory limit)
scan_broken_links — Link triage over a content sample with no outbound HTTP (empty/anchor-only links, dev/staging hosts, unresolved internal links)
list_users — Users with roles and post counts, administrators flagged (never returns secrets)
check_health — Live health gate: HTTP status, PHP fatals, white-screen, database connectivity
scan_error_log — Tails and severity-groups the error log, surfacing recent fatals
check_vulnerabilities — Plugins/themes checked against the WordPress.org vulnerability database
get_seo_meta — Read a post/page’s SEO title, description, and focus keyword from the active SEO plugin (Rank Math, Yoast, or SEOPress)
list_page_blocks — Read a page’s Gutenberg block structure (block names, attributes, nesting)
Write tools (approval-gated):
update_plugin_safely — Backup, update, health-check, auto-rollback on failure
clear_caches — Flush object/opcode caches and detected page-cache plugins
cleanup_transients — Remove expired transients to reduce autoload bloat
cleanup_orphaned_assets — Find and remove unused media (dry-run by default)
backup_plugins — Zip-snapshot one or all active plugins as a rollback safety net
set_seo_meta — Write a post/page’s SEO title / description / focus keyword on the active SEO plugin (Rank Math, Yoast, or SEOPress) — on-site, so it works even when a WAF blocks the plugin’s own REST endpoint
update_page_block — Update a Gutenberg block’s content or attributes (snapshot-first, reversible)
create_page_from_blocks — Create a new page from a Gutenberg block spec (draft-first)
Tools are classified by verb so the Aura Fleet gateway applies the right risk and approval policy automatically.
Pro: the SiteAgent Power Pack
Everything above is free and ships in this plugin. Agencies that need an agent to fix a site — not just report on it — can add the SiteAgent Power Pack, a separate companion plugin that registers higher-capability tools through this plugin’s own tool registry.
It is not included in this download and is not distributed on WordPress.org — the tools it adds execute code, so they don’t belong in a hosted repository. It comes with the Aura Agency and Studio plans, or as SiteAgent Pro.
What it adds:
read_file — read a text file from inside wp-content (jailed; refuses wp-config.php).
db_query — a single read-only SQL statement (SELECT / SHOW / EXPLAIN), row-capped.
write_file — write a file inside wp-content, snapshot-first so it can be rolled back.
run_wp_cli — run an allowlisted WP-CLI command, with no shell and no metacharacters.
execute_php — run a PHP snippet against the full WordPress API.
These are governed harder than anything in the free set, deliberately:
Off until you arm them. The write and code tools do nothing until the site owner sets an explicit constant in wp-config.php for each one. Installing the Power Pack alone enables no writes and no code execution.
Human approval, cryptographically enforced. Once the site holds Aura’s approval key (provisioned when you connect the site), each of these calls requires a single-use, signed grant bound to that exact tool and its exact parameters — one only the Aura dashboard can mint, after a human approves the action. A leaked Site Token cannot run them. (Until a site has that key, the gate is dormant — so connect the site from Aura before arming anything.)
Reversible where it can be. File writes are snapshotted first, so there’s a previous state to restore.
The safety model is governance, not a sandbox: execute_php is powerful by design. The controls are the constant you set, the human who approves the call, and the audit trail — not a promise that arbitrary code is safe.
Learn more at my-aura.app/siteagent.
About Aura
Aura is a full-stack operations dashboard by Digitizer that brings servers, applications, DNS zones, and CDN pull zones from Cloudways, Hostinger VPS, Cloudflare, and Bunny.net into a single unified interface.
SiteAgent extends that reach into every WordPress installation — so you can manage your entire infrastructure, including WordPress sites, from one place.
Free to Use
The plugin is completely free and open source (GPLv2+). You need a free or paid Aura account to connect your sites. Sign up at my-aura.app.
Links
Aura Dashboard
Documentation
GitHub Repository
Digitizer
