Claude Code
Use the BeeL. plugin for Claude Code to implement, audit, and maintain BeeL. API integrations with AI assistance.
The BeeL. plugin for Claude Code is a toolkit for working with the BeeL. API: an always-current integration guide plus dedicated skills to implement an integration, audit it for compliance, build webhook receivers, and detect drift against the live API.
The plugin keeps only stable invariants locally (auth, idempotency, response envelope, invoice lifecycle). Everything else — endpoints, schemas, events — Claude fetches from these docs at the moment of use, so the plugin never goes stale.
Prerequisites
- Claude Code installed
- A BeeL. API key — get one at Settings > API Keys
Installation
Open Claude Code in your project and run:
/plugin marketplace add beel-es/claude-plugins
/plugin install beel-api@beelThat's it. The plugin installs automatically and updates whenever a new version is published.
Skills
Claude Code activates the right skill automatically based on what you ask — no manual invocation needed. You can also invoke them explicitly:
| Skill | What it does |
|---|---|
/beel-api:beel-api | Integration guide: golden rules, auth, doc lookup, plus recipes (typed client / official SDK, webhook handler, invoice flow, fiscal context, debugging, CLI) |
/beel-api:implement | Guided integration: detects your stack, sets up the official SDK or a typed client, and implements the flows you need against the live spec |
/beel-api:audit | Audits your integration code against the BeeL. rules — idempotency, key security, error handling, rate limits, webhook verification, invoice lifecycle — and reports findings with severity and ready-to-apply fixes |
/beel-api:webhooks | Builds a correct webhook receiver: signature verification, raw-body handling, deduplication, retry-aware processing |
/beel-api:upgrade | Checks your integration against the live OpenAPI spec and SDK releases: breaking changes, deprecated patterns, new features worth adopting |
Example prompts
Add BeeL invoice creation to my existing Express checkout webhookAudit my BeeL integration — is it production-safe?Implement a webhook receiver for invoice.paid eventsIs my BeeL integration up to date with the current API?List all ISSUED invoices from the last 30 days and export them to ExcelVerifying against the sandbox
The skills use the BeeL CLI to run real API calls when verifying a flow — sandbox by default, production only with an explicit --live:
npx @beel_es/cli invoices create --data @invoice.json
npx @beel_es/cli invoices get <invoice_id>With a beel_sk_test_ key in BEEL_API_KEY, Claude can create test invoices, trigger webhook events, and confirm your integration works end to end — without writing throwaway scripts.
Machine-readable docs
Claude fetches these URLs directly during a session to get the latest spec or docs:
| URL | Contents |
|---|---|
/llms.txt | Index of all documentation pages |
/llms-full.txt | All docs in a single file |
/api/openapi | Full OpenAPI spec (YAML) |