Kimono BI Connector (WooCommerce)

A lightweight WooCommerce plugin that exposes your store's data through a read API so it can be connected to a Kimono BI instance for analytics, reporting, and forecasting.

This is the WooCommerce companion to the self-hosted Kimono BI platform. You run both yourself and connect them with an API key you generate here.

Installation

1. Copy the kimono-bi-connector.php file (or the whole folder) into wp-content/plugins/kimono-bi-connector/ on your WordPress site.
2. In WP Admin → Plugins, activate Kimono BI Connector.
3. Open the plugin settings page (WooCommerce → Kimono BI). Set URL platforma Kimono BI to the address of your own self-hosted Kimono BI instance, then copy the generated connection details (store URL + API key).
4. In your Kimono BI instance, add a new WooCommerce store and enter those details.

See readme.txt for the WordPress-format plugin readme.

Installing with Claude Code

If your WordPress site lives on a server you can reach with Claude Code (Anthropic's agentic CLI), you can let it do the install. SSH into the server, run npm install -g @anthropic-ai/claude-code, cd into your WordPress root, start claude, and paste:

Install the Kimono BI Connector WooCommerce plugin from
https://github.com/danielbirtas/kimono-bi-connector into this WordPress site:
1. Clone or copy kimono-bi-connector.php into wp-content/plugins/kimono-bi-connector/.
2. Tell me how to activate it (or activate it via WP-CLI if available).
3. Remind me to open WooCommerce → Kimono BI, set my Kimono BI platform URL, and copy the API key.
Explain each step before running it.

You provide your own Kimono BI instance URL and keep the generated API key secret — nothing sensitive is committed anywhere.

Security

The plugin exposes a read endpoint into your store data, protected by the generated API key. Keep that key secret and rotate it if you suspect exposure. See SECURITY.md.

License

Released under the GNU General Public License v2.0 or later (GPL-2.0-or-later), consistent with the WordPress plugin ecosystem. See LICENSE.

The Kimono BI platform itself is licensed separately under AGPL-3.0 with a commercial dual-license option — see the Kimono BI repository.