Authenticate with the review platform API using your API key and app key (Judge.me) or API key and GUID (Yotpo); include these in request headers or query parameters per the platform's documentation
Fetch reviews for a specific product by querying the reviews endpoint with the product external_id or handle, specifying page and per_page for pagination
Parse the review objects from the response, extracting fields such as rating, body, author name, verified_buyer, and created_at timestamp for each review
Store ingested reviews in your local database, deduplicating by the review platform's review ID to prevent duplicate imports during incremental syncs
Push review summary data (average rating, review count) to your product catalog or commerce platform's metafields so the storefront can display star ratings without a live API call per page load
Subscribe to the review platform's webhook for new review events to trigger near-real-time import rather than scheduled polling
Known gotchas
Review platforms gate unpublished or moderated reviews; only published/approved reviews are returned by default — check your moderation settings if review counts seem lower than expected
Rating aggregates displayed on the storefront may drift from the review platform's own count if your sync runs infrequently; refresh aggregates on every new review webhook event
Some review platforms require you to attribute reviews with a link back to their platform for display; check terms of service before rendering review content outside their widget
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp