webflow-agenium
v1.0.0
Published
Webflow API v2 integration for the agent:// protocol (Agenium)
Maintainers
Readme
Webflow-Agenium Integration
Webflow API v2 integration for the agent:// protocol (Agenium). Gives agents full access to Webflow CMS, e-commerce, forms, pages, and webhooks.
Features
- 📝 CMS Collections — CRUD items, bulk operations, publish
- 🛒 E-commerce — Products, SKUs, orders, inventory
- 📋 Forms — Read submissions, webhook triggers
- 📄 Pages — Management, SEO, custom code injection
- 🔔 Webhooks — Real-time Webflow event notifications
- 🌐 Site Publishing — Publish changes programmatically
- 🏥 Health monitoring — Heartbeat with Agenium DNS
Quick Start
npm install
cp .env.example .env
# Set WEBFLOW_API_TOKEN, WEBFLOW_SITE_ID, AGENT_API_KEY
npm run build && npm startAPI Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /.well-known/agent.json | GET | Agent card |
| /agent/collections | GET | List CMS collections |
| /agent/collections/:id/items | GET/POST | List/create items |
| /agent/collections/:id/items/:itemId | PATCH/DELETE | Update/delete item |
| /agent/products | GET/POST | List/create products |
| /agent/products/:id | GET | Get product |
| /agent/orders | GET | List orders |
| /agent/orders/:id/fulfill | POST | Fulfill order |
| /agent/forms | GET | List forms |
| /agent/forms/:id/submissions | GET | List submissions |
| /agent/pages | GET | List pages |
| /agent/pages/:id | PATCH | Update page |
| /health | GET | Health check |
License
MIT
Bug Reporting
This project includes optional bug reporting to the Agenium monitoring server.
Configuration
Set the following environment variables to enable bug reporting:
BUG_REPORT_URL=http://130.185.123.153:3100
BUG_REPORT_TOKEN=your_token_hereBug reporting is disabled by default — it only activates when BUG_REPORT_TOKEN is set. Reports are sent asynchronously (fire and forget) and never block the main application.
