Title: SuggestAPI
Author: cbsuggestapi
Published: 2026 年 9 月 30 日
Last modified: 2026 年 9 月 30 日
---
搜尋外掛
# SuggestAPI
由 [cbsuggestapi](https://profiles.wordpress.org/cbsuggestapi/) 開發
[下載](https://downloads.wordpress.org/plugin/suggestapi.0.2.0.zip)
* [詳細資料](https://tw.wordpress.org/plugins/suggestapi/#description)
* [使用者評論](https://tw.wordpress.org/plugins/suggestapi/#reviews)
* [安裝方式](https://tw.wordpress.org/plugins/suggestapi/#installation)
* [開發資訊](https://tw.wordpress.org/plugins/suggestapi/#developers)
[技術支援](https://wordpress.org/support/plugin/suggestapi/)
## 外掛說明
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.
### Privacy
This plugin connects your site to the SuggestAPI service
(https://www.suggestapi.
com). No data leaves your site until you save API keys.
* Storefront search: each query (`q`, result limit) and your index id are sent
to `https://api.suggestapi.com` to fetch results. Your public key identifies
your account. No visitor cookies are set by these requests.
* Catalog sync (only with a private write key saved): product names,
descriptions,
SKUs, prices, images, stock status, categories, and tags are pushed to `https://
api.suggestapi.com` to keep your search index current.
* Agent discovery (when enabled): your site domain is looked up at
https://agent.
suggestapi.com to resolve your registered agent tenant, and pages carry an `ai-
catalog` link tag pointing at your catalog.
SuggestAPI’s terms and privacy policy apply to data it processes:
https://www.suggestapi.
com/terms/ and https://www.suggestapi.com/privacy/.
## 螢幕擷圖
[⌊Settings: keys, live index picker, and connectivity test.⌉⌊Settings: keys, live
index picker, and connectivity test.⌉[
Settings: keys, live index picker, and connectivity test.
[⌊Advanced tab: sync toggles, batch sizes, shop box, and agent discovery.⌉⌊Advanced
tab: sync toggles, batch sizes, shop box, and agent discovery.⌉[
Advanced tab: sync toggles, batch sizes, shop box, and agent discovery.
[⌊Catalog sync status: queue depth, reindex progress, and last sync.⌉⌊Catalog sync
status: queue depth, reindex progress, and last sync.⌉[
Catalog sync status: queue depth, reindex progress, and last sync.
[⌊Storefront search box above the WooCommerce shop grid.⌉⌊Storefront search box
above the WooCommerce shop grid.⌉[
Storefront search box above the WooCommerce shop grid.
## 安裝方式
1. Upload the plugin folder to `/wp-content/plugins/` or install the zip via Plugins
Add New Upload Plugin.
2. Activate **SuggestAPI** through the Plugins screen.
3. Open the **SuggestAPI** admin menu.
4. Paste the public search key and private write key, save, pick the product index
from the dropdown, and save again.
5. Click **Test search connectivity**, then **Reindex all products**.
6. Put `[suggestapi_search]` on any page, or enable the shop search box.
## 常見問題集
### 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 `` 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.
## 使用者評論
這個外掛目前沒有任何使用者評論。
## 參與者及開發者
以下人員參與了開源軟體〈SuggestAPI〉的開發相關工作。
參與者
* [ cbsuggestapi ](https://profiles.wordpress.org/cbsuggestapi/)
[將〈SuggestAPI〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/suggestapi)
### 對開發相關資訊感興趣？
任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/suggestapi/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/suggestapi/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/suggestapi/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/suggestapi/)。
## 變更記錄
#### 0.2.0
* Search proxy, shortcode, and shop grid search box.
* Variation-level background sync via Action Scheduler with batched writes.
* Agent ai-catalog discovery tag with API-resolved tenant.
* Settings General/Advanced tabs, live index picker, WP-CLI commands.
## 中繼資料
* 版本 **0.2.0**
* 最後更新 **2 天前**
* 啟用安裝數 **少於 10 次**
* WordPress 版本需求 ** 6.0 或更新版本 **
* 已測試相容的 WordPress 版本 **7.1.2**
* PHP 版本需求 ** 8.0 或更新版本 **
* 語言
* [English (US)](https://wordpress.org/plugins/suggestapi/)
* 標籤:
* [autocomplete](https://tw.wordpress.org/plugins/tags/autocomplete/)[product search](https://tw.wordpress.org/plugins/tags/product-search/)
[search](https://tw.wordpress.org/plugins/tags/search/)[typeahead](https://tw.wordpress.org/plugins/tags/typeahead/)
[woocommerce](https://tw.wordpress.org/plugins/tags/woocommerce/)
* [進階檢視](https://tw.wordpress.org/plugins/suggestapi/advanced/)
## 評分
這個項目尚無任何評論記錄。
[撰寫評分](https://wordpress.org/support/plugin/suggestapi/reviews/#new-post)
[查看全部使用者評論](https://wordpress.org/support/plugin/suggestapi/reviews/)
## 參與者
* [ cbsuggestapi ](https://profiles.wordpress.org/cbsuggestapi/)
## 技術支援
使用者可在技術支援論壇提出意見反應或使用問題。
[檢視技術支援論壇](https://wordpress.org/support/plugin/suggestapi/)