SuggestAPI -- WordPress 插件

SuggestAPI

开发者	cbsuggestapi suggestapi
更新时间	2026年9月30日 21:28
PHP版本:	8.0 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

0.2.0

详情介绍:

SuggestAPI adds fast, typo-tolerant product search to WordPress and WooCommerce, keeps your SuggestAPI search index in sync in the background, and publishes an agent-discovery tag so AI shopping agents can find your catalog.

Search box via the [suggestapi_search] shortcode or automatic injection above the WooCommerce shop grid (/shop/).
Server-side search proxy — your API keys never reach the browser.
Background catalog sync: product creates, updates, stock changes, and deletes queue through Action Scheduler (bundled with WooCommerce) with a WP-Cron fallback. Variable products sync per variation.
Full catalog reindex with progress, retry with backoff, and error log.
AI agent discovery: ai-catalog link tag resolved from the SuggestAPI agent gateway for your merchant domain.
WP-CLI commands: wp suggestapi status|test-connection|reindex|index-product.

You need a free SuggestAPI account: paste the public search key and the private write key from the dashboard, pick your product index from the live list, test connectivity, and reindex.

安装:

Upload the plugin folder to /wp-content/plugins/ or install the zip via Plugins → Add New → Upload Plugin.
Activate SuggestAPI through the Plugins screen.
Open the SuggestAPI admin menu.
Paste the public search key and private write key, save, pick the product index from the dropdown, and save again.
Click Test search connectivity, then Reindex all products.
Put [suggestapi_search] on any page, or enable the shop search box.

屏幕截图:

升级注意事项:

0.2.0 Initial WordPress.org release.

常见问题:

Where do I get API keys?

From the SuggestAPI dashboard. The public key powers storefront search; the private key powers background catalog sync and is never printed or sent to browsers.

Which index should I pick?

Your own product index. Click Reload to fetch the live list from your account. Do not sync into shared demo indexes.

Search works but sync stays dormant. Why?

Sync needs all three: WooCommerce active, sync enabled under the Advanced tab, and a private write key saved. The status panel shows exactly which is missing.

Do AI agents see my catalog?

When the agent tag is enabled and your domain is a registered agent tenant, every theme page emits <link rel="ai-catalog" …> pointing at your catalog. The settings page shows the resolved tenant and a link to the live catalog.

Does the plugin call SuggestAPI without keys?

No. Every outbound call checks for its key first; the REST proxy answers 503 when unconfigured, and the shortcode renders no form until keys are saved.

更新日志: