{"id":406692,"date":"2026-11-20T23:03:52","date_gmt":"2026-11-20T23:03:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/vachr-web-search-connector-for-muse-ai\/"},"modified":"2026-11-20T23:03:43","modified_gmt":"2026-11-20T23:03:43","slug":"vachr-web-search-connector-for-muse-ai","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/vachr-web-search-connector-for-muse-ai\/","author":23454938,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.5","requires":"7.0","requires_php":"7.4","requires_plugins":null,"header_name":"Vachr Web Search Connector for Muse AI","header_author":"Radomir Vach","header_description":"Connect WordPress to Muse AI with real web search, visitor chat, a protected REST API, and a PHP helper.","last_updated":"2026-11-20 23:03:43","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":39,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"chuckumi","date":"2026-11-20 23:03:43","revision":3814596}},"upgrade_notice":{"0.1.2":"<p>The shortcode is now <code>[vachr_ai_muse]<\/code>, the REST route is <code>\/wp-json\/vachr-ai-muse\/v1\/chat<\/code> and the PHP helper is <code>vachr_ai_muse_query()<\/code>. Settings are stored under a new name, so review them after updating.<\/p>","0.1.1":"<p>Adds a Web Search switch, 13 translations and connection diagnostics, and reports clearly when a key has no models enabled. If you installed an earlier ZIP whose main file had a different name, delete the old copy first.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3814590,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3814590,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3814590,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3814590,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[2353,2364,683,294285,286810],"plugin_category":[],"plugin_contributors":[259308],"plugin_business_model":[],"class_list":["post-406692","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chatbot","plugin_tags-meta","plugin_tags-muse","plugin_tags-web-search","plugin_contributors-chuckumi","plugin_committers-chuckumi"],"banners":{"banner":"https:\/\/ps.w.org\/vachr-web-search-connector-for-muse-ai\/assets\/banner-772x250.png?rev=3814590","banner_2x":"https:\/\/ps.w.org\/vachr-web-search-connector-for-muse-ai\/assets\/banner-1544x500.png?rev=3814590","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/vachr-web-search-connector-for-muse-ai\/assets\/icon-128x128.png?rev=3814590","icon_2x":"https:\/\/ps.w.org\/vachr-web-search-connector-for-muse-ai\/assets\/icon-256x256.png?rev=3814590","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Vachr Web Search Connector for Muse AI connects WordPress to the Meta Model API (<code>https:\/\/api.meta.ai\/v1<\/code>). It adds Muse AI as a provider to the WordPress AI Client and the native <strong>Settings &gt; Connectors<\/strong> screen, so one API key serves the whole site.<\/p>\n\n<ul>\n<li>Plain chat uses the OpenAI-compatible Chat Completions endpoint.<\/li>\n<li>Web search uses the Responses API with Meta's server-side <code>web_search<\/code> tool and returns the source links the model found.<\/li>\n<li>The API key stays on your WordPress server. It is never sent to visitors or to external applications.<\/li>\n<\/ul>\n\n<h4>What it does<\/h4>\n\n<ul>\n<li>Adds the <code>[vachr_ai_muse]<\/code> shortcode for an optional visitor chat.<\/li>\n<li>Adds a protected <code>POST \/wp-json\/vachr-ai-muse\/v1\/chat<\/code> endpoint for external applications.<\/li>\n<li>Provides <code>vachr_ai_muse_query()<\/code> for other plugins and themes on the same site.<\/li>\n<li>Registers Muse AI in the native Connectors screen (WordPress 7.0+). The API key, created at https:\/\/dev.meta.ai, is managed there.<\/li>\n<li>Lets other plugins use Muse AI through the WordPress AI Client, including structured JSON responses.<\/li>\n<li>Includes a connection diagnostics tool that shows the real reason when a key cannot be connected.<\/li>\n<li>Ships with translations for 13 languages.<\/li>\n<\/ul>\n\n<h4>How web search works<\/h4>\n\n<p>Web search is performed by Meta's server-side tool, not by WordPress and not by a crawler included in this plugin. It is on by default and can be turned off in <strong>Settings &gt; Vachr Web Search Connector for Muse AI<\/strong> (this switch applies to every request, including those made by other plugins). It can also be disabled for a single request:<\/p>\n\n<ul>\n<li>REST API: send <code>\"web_search\": false<\/code>.<\/li>\n<li>Visitor chat: clear the \"Search the web\" checkbox.<\/li>\n<li>PHP helper: pass <code>false<\/code> as the third argument.<\/li>\n<\/ul>\n\n<p>When web search is used, Muse AI may run one or more searches before it answers. This can increase latency and API cost. Source links are returned only when the provider includes them (at most 10 are shown).<\/p>\n\n<h4>Models<\/h4>\n\n<p>The model list is read from your key's <code>\/v1\/models<\/code> response, and only text models are offered (image, voice and segmentation models are hidden). The default is <code>muse-ember-1.0<\/code>, the lowest-cost reasoning model. You can enter any model ID your key may use, for example <code>muse-spark-1.3<\/code> or <code>muse-wonder-1.0<\/code>.<\/p>\n\n<p>If the API accepts your key but returns no models, the connection is refused with an explanation; the plugin never substitutes a made-up model list. Enable a text model for the key at https:\/\/dev.meta.ai.<\/p>\n\n<h4>Languages<\/h4>\n\n<p>Czech, French, German, Italian, Japanese, Korean, Polish, Portuguese (Brazil), Russian, Simplified Chinese, Spanish, Thai and Turkish. The plugin follows the language of your site or of the logged-in user. Translations were prepared by machine; corrections are welcome.<\/p>\n\n<h4>External service and privacy<\/h4>\n\n<p>This plugin connects to the Meta Model API (<code>https:\/\/api.meta.ai\/v1<\/code>), operated by Meta Platforms, Inc. The service provides the Muse AI models that generate the answers and the optional web search. Without it the plugin cannot work.<\/p>\n\n<p>Data sent and when:<\/p>\n\n<ul>\n<li>Every time a chat message, REST API request or PHP helper call is made: the question text, the selected model, the system instructions, whether web search was requested, and your API key (as an Authorization header). Web search can cause Meta to process the question through its search service.<\/li>\n<li>When an administrator opens the Connectors screen: a request to <code>https:\/\/api.meta.ai\/v1\/models<\/code> with the API key to list the available models.<\/li>\n<li>When an administrator uses \"Test connection\" on the settings page: the key typed into the field is sent to <code>https:\/\/api.meta.ai\/v1\/models<\/code>. The key is not saved.<\/li>\n<\/ul>\n\n<p>Your API key is sent only from the WordPress server to Meta, never to visitors. Create and manage keys at https:\/\/dev.meta.ai.<\/p>\n\n<ul>\n<li>Meta Terms of Service: https:\/\/www.facebook.com\/terms<\/li>\n<li>Meta Privacy Policy: https:\/\/www.facebook.com\/privacy\/policy\/<\/li>\n<\/ul>\n\n<p>The plugin does not store questions, responses, source links or conversations in the WordPress database. It does not use analytics or tracking.<\/p>\n\n<p>If the site owner enables the WordPress AI feature <strong>AI Request Logging<\/strong>, requests made through this connector appear in its central AI Request Logs according to that feature's own settings.<\/p>\n\n<p>Before enabling public chat, inform visitors about the data transfer and establish a lawful basis appropriate to your jurisdiction. Do not submit sensitive personal data.<\/p>\n\n<h4>Security<\/h4>\n\n<ul>\n<li>The external REST endpoint requires an integration bearer token, generated on activation and visible only to WordPress administrators. Treat it like a password and replace it if it may have been exposed.<\/li>\n<li>Browser chat requests use a WordPress REST nonce. Public chat is disabled by default.<\/li>\n<li>Public browser requests are limited to 12 per five minutes per IP address.<\/li>\n<li>Questions are limited to 12,000 characters.<\/li>\n<\/ul>\n\n<h3>Developer usage<\/h3>\n\n<h4>REST API<\/h4>\n\n<p>Send a JSON request to your own WordPress site. Never place the integration token in browser JavaScript.<\/p>\n\n<pre><code>POST https:\/\/your-site.example\/wp-json\/vachr-ai-muse\/v1\/chat\n<\/code><\/pre>\n\n<p>Headers: <code>Authorization: Bearer YOUR_INTEGRATION_TOKEN<\/code> and <code>Content-Type: application\/json<\/code><\/p>\n\n<pre><code>curl -X POST https:\/\/your-site.example\/wp-json\/vachr-ai-muse\/v1\/chat -H \"Authorization: Bearer YOUR_INTEGRATION_TOKEN\" -H \"Content-Type: application\/json\" -d '{\"message\":\"What changed in WordPress this week?\",\"web_search\":true}'\n<\/code><\/pre>\n\n<p>Request fields:<\/p>\n\n<ul>\n<li><code>message<\/code> (string, required): the question, up to 12,000 characters.<\/li>\n<li><code>web_search<\/code> (boolean, optional): use web search; defaults to <code>true<\/code>. Ignored when web search is switched off in the plugin settings.<\/li>\n<\/ul>\n\n<p>Response: <code>{ \"text\": \"...\", \"sources\": [ { \"title\": \"...\", \"url\": \"...\" } ], \"usage\": { ... } }<\/code><\/p>\n\n<h4>PHP helper<\/h4>\n\n<pre><code>$result = vachr_ai_muse_query( 'Summarise today\\'s WordPress news.', '', true );\n<\/code><\/pre>\n\n<p>Arguments: the question, an optional model ID (empty uses the saved model), and whether to use web search. It returns an array with <code>text<\/code>, <code>sources<\/code> and <code>usage<\/code>, or a <code>WP_Error<\/code>.<\/p>\n\n<h4>WordPress AI Client<\/h4>\n\n<p>Muse AI is registered as the provider <code>muse<\/code>, so other plugins can use it with <code>wp_ai_client_prompt()-&gt;using_provider( 'muse' )<\/code>. Request web search with the <code>web_search<\/code> custom option on the model configuration.<\/p>\n\n<h4>Filters<\/h4>\n\n<ul>\n<li><code>vachr_ai_muse_request_timeout<\/code> (float, default <code>600.0<\/code>): request timeout in seconds.<\/li>\n<li><code>vachr_ai_muse_web_search_enabled<\/code> (bool): override whether web search is allowed.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin on WordPress 7.0 or newer.<\/li>\n<li>Go to Settings &gt; Connectors and add your Meta Model API key (create one at https:\/\/dev.meta.ai).<\/li>\n<li>Go to Settings &gt; Vachr Web Search Connector for Muse AI, choose a model (default <code>muse-ember-1.0<\/code>) and save.<\/li>\n<li>To show the visitor chat, enable \"Allow Chat for Visitors\" and add <code>[vachr_ai_muse]<\/code> to a page or post.<\/li>\n<li>For an external integration, copy the Integration Token from the same settings screen into that application's secret manager.<\/li>\n<\/ol>\n\n<p>If the connector will not connect, open Settings &gt; Vachr Web Search Connector for Muse AI &gt; Connection diagnostics, paste the key and press \"Test connection\". The report shows the HTTP result and the exact error.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"the%20connectors%20screen%20says%20%22it%20was%20not%20possible%20to%20connect%20to%20the%20provider%20using%20this%20key.%22\"><h3>The Connectors screen says \"It was not possible to connect to the provider using this key.\"<\/h3><\/dt>\n<dd><p>That message is generic. Use Connection diagnostics (see Installation) to see the real cause: a blocked outbound connection, an invalid key, or a key that has no models enabled.<\/p><\/dd>\n<dt id=\"my%20key%20is%20accepted%20but%20the%20connector%20will%20not%20connect.\"><h3>My key is accepted but the connector will not connect.<\/h3><\/dt>\n<dd><p>If <code>\/v1\/models<\/code> returns an empty list, no model is enabled for the key. Enable a text model at https:\/\/dev.meta.ai and try again.<\/p><\/dd>\n<dt id=\"do%20i%20need%20to%20add%20the%20api%20key%20to%20this%20plugin%27s%20settings%3F\"><h3>Do I need to add the API key to this plugin's settings?<\/h3><\/dt>\n<dd><p>No. The key is stored by WordPress in Settings &gt; Connectors and is passed to the plugin by the AI Client.<\/p><\/dd>\n<dt id=\"why%20are%20the%20answers%20slow%3F\"><h3>Why are the answers slow?<\/h3><\/dt>\n<dd><p>Muse models reason before answering, and web search adds one or more search steps. Lower the cost and latency by using <code>muse-ember-1.0<\/code> or by turning web search off.<\/p><\/dd>\n<dt id=\"can%20visitors%20use%20the%20chat%3F\"><h3>Can visitors use the chat?<\/h3><\/dt>\n<dd><p>Only if you enable \"Allow Chat for Visitors\" and place <code>[vachr_ai_muse]<\/code> on a page. Otherwise only administrators can use it.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release<\/li>\n<\/ul>\n\n<h4>0.1.2<\/h4>\n\n<ul>\n<li>Rename the shortcode to <code>[vachr_ai_muse]<\/code>.<\/li>\n<li>Prefix all classes, functions, options, hooks, the REST namespace and the CSS classes with <code>vachr_ai_muse<\/code> to avoid name collisions. The settings are stored under a new option name, so re-save them after updating.<\/li>\n<li>The REST route is now <code>\/wp-json\/vachr-ai-muse\/v1\/chat<\/code> and the PHP helper is <code>vachr_ai_muse_query()<\/code>.<\/li>\n<li>Stop declaring the connector setting name; WordPress derives it automatically.<\/li>\n<li>Document the external Meta Model API service, the data sent and the terms and privacy links.<\/li>\n<\/ul>\n\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>Add a setting to enable or disable Web Search for all requests; other plugins request it with the <code>web_search<\/code> custom option.<\/li>\n<li>Support structured JSON responses requested through the WordPress AI Client.<\/li>\n<li>Stop inventing a fallback model list: when the API returns no models for the key, an explanatory error is shown.<\/li>\n<li>Add a Connection diagnostics tool to the settings page.<\/li>\n<li>Skip the intermediate progress message that web search placed before the final answer, and limit sources to 10.<\/li>\n<li>Add translations for 13 languages and load the bundled translations without <code>load_plugin_textdomain()<\/code>.<\/li>\n<li>Use <code>muse-ember-1.0<\/code> as the default model.<\/li>\n<li>Show the full plugin name in the Settings menu.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial version.<\/li>\n<\/ul>","raw_excerpt":"Connect WordPress to Meta's Muse AI models with provider-powered web search, an optional visitor chat, a protected REST API, and a PHP helper.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/406692","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=406692"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/chuckumi"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=406692"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=406692"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=406692"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=406692"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=406692"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=406692"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}