=== SearchCue: AI Site Search & Answers ===
Contributors: donoharm
Tags: search, site search, ai search, chatbot, ai answers
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 0.1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fast, typo-tolerant site search with cited AI answers for your pages and documents. Fast setup, no code, and no local search index.

== Description ==

SearchCue adds real-time, typo-tolerant search to WordPress, with semantic matching for natural-language searches and optional cited AI answers grounded in your indexed site content.

**Compatibility**

The clean-install matrix covers WordPress 6.0 through 7.0 and PHP 7.4 through 8.5. It tests the PHP 7.4 floor on WordPress 6.0, every PHP 8 minor, and the available PHP 8.2 and 8.5 boundaries on WordPress 7.0 with debugging enabled.

SearchCue crawls your public pages and supported documents, then builds and serves the search index from its own servers. It does not build a search index in your WordPress database. Connect with an email magic link, and SearchCue can work with your theme's existing search input, the built-in floating search launcher, or any link to `/search`.

**What you get**

* Real-time, typo-tolerant results that appear as visitors type
* Optional cited AI answers generated from your indexed site content, with links to the sources used
* Semantic matching that can find relevant pages even when a query uses different wording
* Search across pages, PDFs, Word documents, PowerPoint presentations, and other supported documents
* OCR and image understanding that can make image content discoverable when useful text is missing
* Search lenses for including or excluding URL paths and serving the right content for different site sections or language paths
* Built-in search analytics showing popular terms, clicks, and searches that returned no results
* A hosted design editor for adapting the search interface without changing the plugin
* Optional automatic content-update notifications when public pages, posts, custom post types, or attachments change

**Works beyond WordPress**

The same SearchCue account can also provide search for Webflow, Shopify, Squarespace, and hand-built sites.

**Hosted service disclosure**

SearchCue is a software-as-a-service (SaaS) product operated by DoNoHarm - Bauer & Eide GbR. This plugin connects your site to SearchCue, which crawls or receives public content, hosts the search index, and serves visitor searches and optional AI answers. A SearchCue account is required. The plugin does not provide search locally without the hosted service.

By connecting a site, an administrator agrees to the SearchCue terms and acknowledges the privacy policy:

* Service: [https://searchcue.com/](https://searchcue.com/)
* Terms and Conditions: [https://searchcue.com/terms/](https://searchcue.com/terms/)
* Privacy Policy: [https://donoharm.world/privacy-policy/searchcue/](https://donoharm.world/privacy-policy/searchcue/)

**Pricing**

The WordPress plugin is free and licensed under the GPL. The hosted SearchCue service offers a 15-day free trial with no credit card. Continued use after the free trial requires a paid subscription. Plans currently start at €9 per month and include an AI answer allowance. Administrators can set a hard monthly AI budget; when it is reached, SearchCue can fall back to keyword results at no additional AI cost. Continuing AI answers beyond the included allowance is optional. See the [current SearchCue pricing and plan limits](https://searchcue.com/#pricing).

== External services ==

SearchCue is a hosted site search and optional cited AI answer service. The plugin makes these external requests:

* Setup and admin analytics: When an administrator submits the connection form, the plugin sends the email address, site URL, WordPress admin return URL, and a random setup state to `https://central.searchcue.com`. It later exchanges a one-time handoff token there and uses the assigned API key to retrieve site search analytics.
* Automatic content updates: While Automatic updates is enabled, the plugin sends the site hostname, an IndexNow verification key, and changed public URLs to `https://central.searchcue.com` so SearchCue can refresh the index. Administrators can disable this in SearchCue settings.
* Visitor search: After the site is connected, public pages load executable code from `https://searchcue.com/search-embed.js`. That embed contacts `https://central.searchcue.com` and `https://edge.searchcue.com` to load settings, perform searches, and record visitor search terms, originating page paths, whether searches returned results, clicked result paths, and search performance and outcome metrics. If cited answers are enabled, visitor questions and relevant indexed excerpts are sent to SearchCue for cited answer generation.

Admin interface fonts are bundled with the plugin under the SIL Open Font License 1.1 and do not make external requests. The font license texts are included with the font files.

Like other web requests, these connections disclose network information such as the requester IP address and browser user agent. SearchCue uses the data to provide, secure, maintain, troubleshoot, and improve the service and to show search analytics to the site administrator. Site administrators are responsible for providing any visitor privacy notices and obtaining any consent required for their site.

Use of the service is governed by the [SearchCue Terms and Conditions](https://searchcue.com/terms/). Data handling is described in the [SearchCue Privacy Policy](https://donoharm.world/privacy-policy/searchcue/).

== Installation ==

1. Install and activate SearchCue through the WordPress Plugins screen.
2. Open SearchCue in WordPress admin and enter your email address.
3. Follow the magic link to sign up or sign in and connect the site.
4. SearchCue crawls the site and enables its floating search launcher. It can also use your existing search input or any link to `/search`.

== Frequently Asked Questions ==

= Do I need to change my theme or add code? =

No. SearchCue includes a floating search launcher and can take over a standard search input or any link to `/search`. As with other frontend plugins, the theme must call the standard WordPress `wp_head()` function.

= Does it slow down my site or database? =

The browser embed loads asynchronously, and SearchCue does not build or query a local search index. The plugin stores its settings in WordPress and, when Automatic updates is enabled, sends notifications after public content changes.

= Does it search PDFs and office documents? =

Yes. Supported PDFs, Word documents, PowerPoint presentations, and spreadsheets can be indexed alongside your pages, so manuals, specifications, and price lists can appear in results.

= Does it search images? =

SearchCue can use OCR to read text inside images and image understanding to describe what they show. This can make image content discoverable even when captions or alt text are missing.

= What are cited AI answers? =

SearchCue can answer a visitor's question using indexed content from your site and link to the sources used. AI answers can be incomplete or inaccurate, so visitors should use the cited sources to verify important information.

= Does it answer unrelated general-knowledge questions? =

SearchCue is designed to answer from the content indexed for your site. If the indexed sources do not support an answer, it should say that it could not find one rather than inventing an answer.

= Does it provide faceted filters or refinement menus? =

Not currently. SearchCue focuses on fast search, semantic matching, and cited AI answers. If faceted filtering is required, SearchCue may not be a fit yet.

= Can I limit search to one section or language? =

Yes. Search lenses can include or exclude URL paths and select different content for sections or language paths on your site.

= Can I disable automatic content updates? =

Yes. Disable Automatic updates in the SearchCue settings page to stop the plugin from sending changed public URLs.

= Does SearchCue work without an account? =

No. The plugin is an interface to the hosted SearchCue service. An account and an active trial or paid subscription are required for hosted search.

= What does it cost? =

The plugin is free. The hosted service has a 15-day free trial with no credit card. Paid plans currently start at €9 per month. Current prices and limits are listed on the [SearchCue pricing page](https://searchcue.com/#pricing).

== Changelog ==

= 0.1.0 =

* Initial WordPress.org release.
