Skyphusion AI for Cloudflare

Skyphusion AI for Cloudflare

Details
View on WordPress

This plugin connects your site to Cloudflare® AI Search. Open Settings, then Skyphusion AI. Paste your public endpoint address there. You can set the same options with wp skyphusion-ai.

Why this plugin was written: other plugin solutions did not meet our needs. We wanted other people to be able to harness the capabilities of AI Search and agents on their WordPress and WooCommerce site without paying a fee to get the harness. So here you go.

This plugin is free. It provides access to Cloudflare services only. It is not a funnel to any other service. Cloudflare free plans work. Past those plans, you pay Cloudflare.

Visitors get a search box. They can also open the keyboard search with Ctrl+K or Command+K. You can turn on a chat button as well.

WordPress and WooCommerce call Workers AI through the AI Client. The provider id is skyphusion-ai. Open Settings, then Connectors. Save the API token there. This plugin does not store the token.

Set the account id on the Skyphusion AI screen. Add a gateway id only when calls should go through AI Gateway. The screen also links to Workers AI, AI Gateway, and AI Search.

One switch prints an AI Search answer above WordPress and WooCommerce search results. The switch is off until you turn it on. Errors stay off the page.

A single product page also prints its stock as text. Each variation names its attributes, its SKU, its price, and its stock. A simple product names its stock. The text sits in the page itself. A crawler that does not run JavaScript can index it.

The same page adds the SKU, the stock status, and the managed stock count to the meta description. Rank Math and Yoast both receive that sentence. The AI Search dropdown quotes it. A product that does not manage stock gets the SKU and the status, and no count. You do not add a custom field for this sentence.

You can also add a stock_quantity number field on the instance. That field is a filter. It is not what the dropdown prints. The steps, including Wrangler, are in the FAQ.

This plugin does three jobs, and it does not charge a license for any of them.

Search. The box is Cloudflare AI Search. The card shows the product image, the title, and the description. The image is the page image. You do not add a field for it. On a product page the description gains the SKU, the stock status, and the managed stock count. SearchWP, FiboSearch, Relevanssi, and YITH WooCommerce Ajax Search are keyword or instant search. They charge a license. They are not this search.

Chat. You can turn on a chat button. It answers in a sentence. The site assistant streams its answer. A product answer shows the image, the SKU, the stock status, and the managed count, and it links to the product. It does not add the product to the cart. See docs/worker.md. It is not a staff inbox, and it has no seats. You can expand that button with Cloudflare Workers AI or with Cloudflare AI Gateway. Workers AI is the provider on the AI Client. It covers text, vision, JSON, tools, images, speech, and embeddings. Leave the gateway id blank to call api.cloudflare.com. Set a gateway id to send those calls through gateway.ai.cloudflare.com. If that host refuses a call, Workers AI uses api.cloudflare.com for one hour and the screen says so. An empty gateway id stays on api.cloudflare.com. Log prompts only on the gateway host. Embedding calls do not log prompts. The log includes the plugin version. An image failure on a saved dynamic route does not start the hour. Tidio is a help desk. Its Starter plan was $24.17 a month when read on 2026-10-25, and its AI agent, Lyro, starts at $32.50 a month. AIPCF is a free Cloudflare provider. Its site assistant answers from the site’s pages and is off until you turn it on. It is not a help desk.

Agents. WordPress and WooCommerce call Workers AI through the AI Client. The provider covers text, vision, JSON, tools, images, and speech. Embeddings are included. You can expand those calls the same way, with Workers AI or with AI Gateway. This plugin does not edit posts. AI Engine is free, and AI Engine Pro starts at $69 a year for one site. You still pay the model vendor there. AIPCF is free. It is a Cloudflare provider for the WordPress AI Client, and its readme also offers Qdrant and PostgreSQL for embeddings. Here the plugin fee is $0. You use a Cloudflare account. Cloudflare free plans work. Past those plans, you pay Cloudflare. Embeddings stay in Cloudflare Vectorize. The plugin does not send the site to another company.

The tables, the renewal figures, and the page each price came from are in the Compared section of README.md. Every price was read on 2026-10-25 from that vendor’s own page.

Shortcode: [cloudflare_ai_search]

Example:

wp_ai_client_prompt( 'Write a product summary.' )->using_provider( 'skyphusion-ai' );

Other plugins can call cloudflare_ai_provider_embeddings() and skyphusion_ai_query(). cloudflare_ai_search_query() still calls the same helper. The search helper posts to the public chat/completions path. It does not send a token.

Cloudflare, the Cloudflare logo, and Cloudflare Workers are trademarks and/or registered trademarks of Cloudflare, Inc. in the United States and other jurisdictions. This plugin is an independent work. Cloudflare, Inc. does not sponsor or endorse it.

External services

This plugin connects to Cloudflare services. Each service is in the Cloudflare account of the site owner. The plugin does not connect to a service of the plugin author. Nothing is sent until you set the values that turn on that service. Cloudflare, Inc. provides all of these services.

  • Cloudflare terms of service: https://www.cloudflare.com/terms/
  • Cloudflare service-specific terms for Workers AI, AI Gateway, Vectorize and Workers: https://www.cloudflare.com/service-specific-terms-developer-platform/
  • Cloudflare privacy policy: https://www.cloudflare.com/privacypolicy/

Cloudflare AI Search

What it is: the search box, the keyboard search and the chat button. Host: your own instance on search.ai.cloudflare.com.

The plugin loads a JavaScript file from your own AI Search instance. Your browser runs that file. The file is search-snippet.es.js, pinned to snippet build 0.0.25. The plugin builds the address from the public endpoint you paste. It accepts only an https address on search.ai.cloudflare.com. It rejects any path, query, fragment or user information in that address. It checks the address again every time it reads the setting. The plugin loads no script until you paste an endpoint. It also loads none until you turn on the search box, keyboard search or chat.

What is sent and when: the visitor’s browser sends the search words or the chat question to the instance when the visitor searches or asks. The browser request also carries the visitor’s IP address and user agent, as every web request does. The site sends a test request to /search when an admin checks the connection. The site sends the search words to /chat/completions when the search-results answer is on and a visitor searches the site, and when another plugin calls the search helper. None of these requests send an API token.

Cloudflare Workers AI

What it is: the AI models that write, read images, make images, speak, translate and make embeddings. Host: api.cloudflare.com.

What is sent and when: the plugin sends a request only when a feature that you turned on needs a model, or when an admin or another plugin calls the AI Client with the provider skyphusion-ai. The request contains the prompt for that job. That can be a prompt from another plugin, a site assistant question and the stored passages that answer it, the post title and up to 6000 characters of post text for an empty SEO description, an image for empty alt text, text to translate, text to speak, or post passages for embeddings. The request also carries the account id and the API token. The plugin also reads the list of models on the account when it needs that list. It keeps the list for 12 hours. A failed read waits 10 minutes before the next try. That request sends the account id and the API token only.

Cloudflare AI Gateway

What it is: an optional proxy for the same Workers AI calls. It can log, cache and limit those calls. Host: gateway.ai.cloudflare.com.

What is sent and when: only when you save a gateway id. The same Workers AI requests then go to this host instead of api.cloudflare.com. Each request also sends a tag with the site address, the feature name, the model and the WordPress user id. A visitor sends an empty user id. The tag does not contain the prompt. Prompts are logged only when you turn on logging in your gateway.

Cloudflare Vectorize

What it is: the store for post embeddings. Related pages, member search and the site assistant read it. Host: api.cloudflare.com.

What is sent and when: only when embeddings are on. When a published post is saved, or when an admin runs the sync, the plugin sends that post’s vectors and this data for each passage: the post id, the post type, the title, the address, the terms, and for a product the image address, the SKU, the stock status and the stock count. A search by a signed-in member or by the site assistant sends the vector of the question. Each request carries the account id and the API token.

Cloudflare Workers

What it is: an optional assistant Worker that answers from the stored pages. Host: api.cloudflare.com for the deploy, and your own address on workers.dev for the Worker.

What is sent and when: only when an admin deploys the Worker from the settings screen or with WP-CLI. The deploy sends the Worker code, the site address, the model id, the index name and a shared secret. After the deploy, the visitor’s browser sends the question and the earlier turns of that chat to the Worker. The Worker calls the site once each hour with the shared secret to ask for the next empty text. When the Worker address is saved, a member search also sends the search words to the Worker.

Details

Plugin code:
skyphusion-ai
Plugin version:
0.6.3
Author:
Outdated:
No
WP version:
6.4 or higher
PHP version:
8.0 or higher
Test up to WP version:
7.1.4
Total installations:
0
Last updated:
2026-11-08
Rating:
Times rated:
0
ai
cloudflare
search
woocommerce