內容簡介
Kukuriya 是一款 WordPress 外掛，能將多個聯盟服務提供商（ASP）的產品連結整合為單一「產品」，並集中管理。它完全與區塊編輯器整合，涵蓋產品搜尋、卡片渲染、比較表及自動價格更新等功能，特別適合從 Pochipp 遷移的使用者及面對 Amazon API 進入障礙的聯盟行銷人員。
【主要功能】
• 通用連結：一個產品對應多個 ASP 的報價
• 連接器架構：每個 ASP 整合為獨立模組
• 現代區塊編輯器：產品搜尋及屬性編輯介面
• 一鍵註冊：透過 URL 貼上自動註冊產品
• 內建五種卡片範本：包含比較表功能
• 可自定義的比較表：可調整行列及標記
外掛標籤
開發者團隊
原文外掛簡介
Kukuriya is a WordPress plugin that bundles product links from multiple affiliate service providers (ASPs) into a single “product” and manages them in one place. It is fully integrated with the Block Editor, covering everything from product search to card rendering, comparison tables, and automatic price updates.
It is aimed at people migrating from Pochipp, affiliate marketers struggling with the Amazon API entry barrier, and anyone who wants to manage multiple ASPs across one site.
Key features
Universal Link: one product = a set of offers from multiple ASPs. A data model that lets you serve the best link depending on user, stock, and price
Connector architecture: every ASP integration is an isolated connector module. Five official connectors ship built in and can be toggled per site, and third-party connectors can be added as separate plugins via a public hook
Modern Block Editor: product search modal, block insertion, and attribute editing UI built with TypeScript + React 18 + @wordpress/scripts
One-action registration by URL paste: paste a Rakuten or Amazon product page URL into the Block Editor to identify, fetch, and register the product CPT automatically. SiteStripe short URLs (amzn.to / amzn.asia) are expanded automatically. Also useful as a rescue path for products that do not appear in search results
5 built-in card templates: Simple / Card / Compact / Pochipp compatible (visual parity for migrating users), plus a comparison table block for up to 10 products
Comparison tables you can actually shape: reorder the rows, add your own from custom fields or free text, mark cells with ◎ ○ △ ×, turn a cell into a bullet list, highlight the one that decides it, put the products down the side instead of across the top, give each column its own button text and colour, and add a heading above the table
Design controls: 4 visual presets (Neo / Outline / Glass / Bold), custom card frames (width / color), button styles (solid / outlined / gradient / raised), an optional “See reviews” link, and animated frame and button effects (glow, pulse, shine, aurora) that pause automatically for visitors who prefer reduced motion — configurable site-wide or per block
Custom fields: add per-product spec fields in 5 types (text / number / select / boolean / date) with editing and CSV round-trip support
CSV import / export: full CSV round-trip including custom fields, with dry-run validation
Pochipp migration: import products and affiliate URLs from an existing Pochipp install (CPT pochipps). Amazon ASIN / Rakuten item code / Yahoo seller_id + itemcode are mapped automatically
Automatic price refresh cron: re-fetches Amazon / Rakuten / Yahoo prices every 6 hours. Failed items are retried with interval protection for stable operation
Click tracking on your own site (anonymized): a small script reports purchase-button clicks to your site’s own REST API and the dashboard shows which products, stores and posts get clicked. IP / UA are hashed with HMAC-SHA256, referrers keep the host only, no cookies. Can be switched off under “Measurement”
Automatic product description generation (external API): a Composer Service that can call a vendor-neutral Messages-style API. Users configure their own API key
Optional credit: off by default. If you want to show where the cards come from, a switch under Design adds a small mark and the name “Kukuriya” at the bottom right of cards and comparison tables. It is never a link, and nothing about the plugin depends on it
Internationalization: every string is translatable (text domain: kukuriya). Translation contributions via translate.wordpress.org are welcome
Supported ASPs (all built in — enable the ones you use)
Amazon (Creators API, 15 marketplaces)
Rakuten Ichiba (Rakuten IchibaItem Search API v2)
Yahoo! Shopping (Shopping Web Service V3 + ValueCommerce affiliate URL support)
Moshimo Affiliate (link conversion; an alternative route without Amazon keys)
Mercari (Mercari Ambassador: your afid is appended to Mercari links — search links and per-product links)
Manual entry (A8.net / afb / ValueCommerce, etc.) (a generic connector for ASPs without a product API)
Usage notes
The Amazon Creators API requires per-account credentials (a central proxy model is not permitted under its licence)
Amazon grants API access only to accounts with at least 10 qualifying sales in the trailing 30 days. The Moshimo Affiliate route can be used as an alternative
Please follow the terms of service of each ASP
External services
This plugin talks to the shopping services whose connectors you turn on, using API keys that you supply. Nothing is sent anywhere until you enter credentials and enable a connector, and no data is ever sent to the plugin author.
Amazon Product Advertising / Creators API (Login with Amazon)
This plugin connects to Amazon’s product API to search Amazon’s catalogue and to obtain a product’s title, image, price and availability. It is needed to show the product cards you place in your posts and to keep their prices current. It is used only if you turn on the Amazon connector and enter your own credentials.
It sends your Client ID and Client Secret to obtain an access token (api.amazon.com, api.amazon.co.jp or api.amazon.co.uk, depending on the marketplace you choose), and then, on each product search, scheduled price refresh and card render that misses the cache, it sends the search keyword or product ASIN together with that token and your Associates tag. The scheduled refresh runs every 6 hours for products you have registered. If you paste a SiteStripe short URL (amzn.to or amzn.asia) into the editor, your site also makes one request to that address to find out which product it points to.
This service is provided by “Amazon.com, Inc.”: terms of use, privacy policy.
Rakuten Web Service (Rakuten Ichiba Item Search API)
This plugin connects to the Rakuten Ichiba Item Search API at openapi.rakuten.co.jp to search Rakuten Ichiba and to obtain a product’s title, image, price and availability. It is needed to show the product cards you place in your posts and to keep their prices current. It is used only if you turn on the Rakuten connector and enter your own Application ID and Affiliate ID.
It sends your Application ID and Affiliate ID together with the search keyword or item code, on each product search, scheduled price refresh and card render that misses the cache. The scheduled refresh runs every 6 hours for products you have registered.
This service is provided by “Rakuten Group, Inc.”: terms of use, privacy policy.
Yahoo! Shopping Web Service
This plugin connects to the Yahoo! Shopping Web Service at shopping.yahooapis.jp to search Yahoo! Shopping and to obtain a product’s title, image, price and availability. It is needed to show the product cards you place in your posts and to keep their prices current. It is used only if you turn on the Yahoo connector and enter your own Client ID.
It sends your Client ID together with the search keyword or item code, on each product search, scheduled price refresh and card render that misses the cache. The scheduled refresh runs every 6 hours for products you have registered.
This service is provided by “LY Corporation”: terms of use, privacy policy, developer guidelines.
A text generation API of your choosing (optional, off by default)
The optional “generate a product description” button sends a prompt to an API endpoint that you enter in the settings. The plugin does not pick a provider for you and ships no endpoint, no key and no default address of its own. If you leave the setting empty, nothing is ever sent and the button does nothing.
It sends, only when you press that button, a prompt containing the product’s title, price and categories, plus the API key you entered, to the endpoint you entered.
This service is provided by whichever company you configure. Its terms of use and privacy policy are that company’s own. Please read them before entering an endpoint and a key.
Your analytics service (optional, off by default)
If you turn on click measurement under “Measurement”, clicks on purchase buttons are reported to the analytics service whose tag is already installed on your site by you or your theme. This plugin bundles no analytics tag and adds none; your server sends nothing. The reader’s browser reports the click through that existing tag.
It sends, on a click — the product ID, the product name (first 60 characters), which store was clicked, whether the link went to a product page or to search results, and which card in the article it was. The affiliate URL, IP addresses, user agents and post content are never included.
This service is provided by whichever analytics company you already use. Its terms of use and privacy policy are that company’s own.
Services this plugin does NOT contact
Moshimo Affiliate, A8.net, afb, ValueCommerce and Mercari are supported by building the correct affiliate URL on your own server, from the IDs you enter. The plugin makes no request to any of them, and sends them no data. Their addresses appear in the source code only as the destination your visitors’ own browsers go to when they click a link.
Source code and build
The admin screens and editor blocks are written in TypeScript and SCSS and compiled with @wordpress/scripts (webpack). The uncompiled sources are included in this plugin under assets/src/, next to the compiled output in build/, together with package.json, webpack.config.js and tsconfig.json.
To reproduce the compiled files, with Node.js 20 or later:
npm install
npm run build
No third-party JavaScript libraries are bundled. Everything the scripts use at runtime (@wordpress/element, @wordpress/components, and so on) is provided by WordPress itself.
Privacy Policy
Kukuriya stores the following anonymized data for click tracking (in the wp_bcore_clicks table):
HMAC-SHA256 hash of the IP address (64 hex chars)
HMAC-SHA256 hash of the User-Agent (64 hex chars)
Referrer host name only (no path / query)
An opaque per-tab session ID generated client-side in sessionStorage (optional)
Product ID / post ID / which store button / product page or search / card position / timestamp
Raw IPs, raw User-Agents, and full URLs are never stored. No cookies are used. Rows are deleted after 90 days. Recording can be switched off under “Measurement”.
By default, external communication happens only with the ASPs you configured, using your own API keys. No data is sent to the plugin developer (Pifto Works) unless you explicitly enable it.
If you enable the automatic product description feature, prompts containing product information (title / price / categories, etc.) are sent to the external generation API endpoint you configured. You choose and configure both the destination endpoint and the API key.
If you enable the opt-in click measurement feature (Kukuriya > Measurement, disabled by default), purchase button clicks are reported to the analytics service whose tag is installed on your site. What is sent: the product ID stored on your site, the product name (truncated to 60 characters), which store button was clicked, whether it linked to a product page or to search results, and which card in the article it was. What is never sent: the affiliate URL itself, IP addresses, user agents, product descriptions, post content, or any user-entered free text. Nothing is transmitted from your server; the reader’s browser reports the click through the analytics tag that is already loaded on the page. Turning the setting off stops the transmission immediately.
