このMCPでできること
Searches a verified shop database, retrieves shipping and merchant trust information, compares available offers and coupons, and records data issues.
機能
ツール
8
ツール
find_shop
Search merchants/shops by free-text query (name or domain fragment), optionally filtered by country (ISO 3166-1 alpha-2, e.g. "DE") and/or by an EXACT category slug. Returns the public shop view only â shops still under internal review are never returned. `results` carries at most `limit` entries (default 50, max 100); `total_count` is the full match count before that cap and `truncated` is true when more results exist beyond this page â raise `offset` (default 0) to page through them. Multi-word queries are matched conjunctively: every word must be evidenced on a shop (name, domain or category). `ignored_terms` lists the words that matched nothing anywhere in the corpus and were therefore dropped to avoid an empty answer â a non-empty `ignored_terms` means the results answer a NARROWER question than you asked, so do not present them as satisfying those words. `category_truncated` is true when category resolution hit its internal cap and the match set is a subset. `category`, if given, must be one of the slugs returned by `list_categories` â call that tool first, do not guess a slug; an unrecognized slug is rejected with an error (never a silent empty `results`). `category` is additive to `query` (AND, not OR) â pass `query: ""` to browse a category without a name/domain filter. If many shops match, grouping by country or category keeps the list scannable.
読み取り専用
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 512}, 'offset': {'type': 'integer', 'minimum': 0}, 'country': {'type': 'string', 'maxLength': 512}, 'category': {'type': 'string', 'maxLength': 128}}, 'additionalProperties': False}
get_shipping_policy
What a shop STATES about its own shipping: which destinations it names, the delivery time it claims, and any free-shipping threshold â plus the date that statement was last checked and where it was read (policy_page or structured_data). This is a shop-level statement, NOT an offer and NOT a quote: it carries no carrier and no shipping price, because OpenShopGraph does not hold that data. Pass country (ISO 3166-1 alpha-2, e.g. "DE") to get a ships_to verdict derived from the stated destination list â "unknown" is a real answer there and means the statement does not settle it. When nothing has been collected for a shop, the reply says so explicitly (collected:false): that is a gap in the data, not a statement that the shop does not ship. Relaying the checked-at date alongside any figure keeps a stale merchant claim from being read as a current fact.
読み取り専用
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['shop_domain'], 'properties': {'country': {'type': 'string', 'maxLength': 512}, 'shop_domain': {'type': 'string', 'maxLength': 512, 'description': 'Shop domain, e.g. "otto.de". An internal OpenShopGraph shop id is accepted here as well. The older field name `shop_id_or_domain` still works on every tool and means exactly the same thing.'}}, 'additionalProperties': False}
get_shop
Fetch a single merchant/shop by id or domain (public view). Returns "shop not found" for shops still under internal review, identical to a genuinely unknown domain â reviewers cannot be distinguished from typos. The offers array is present for schema stability but empty until merchant offers are ingested (Offer table measured empty on 2026-07-30).
読み取り専用
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['shop_domain'], 'properties': {'shop_domain': {'type': 'string', 'maxLength': 512, 'description': 'Shop domain, e.g. "otto.de". An internal OpenShopGraph shop id is accepted here as well. The older field name `shop_id_or_domain` still works on every tool and means exactly the same thing.'}}, 'additionalProperties': False}
get_trust
Trust-relevant facts OpenShopGraph itself measured about one merchant/shop (by id or domain): TLS certificate issuer and grade, hosting ISP and country, domain registration date, registrar, and accepted payment methods. Returns INDIVIDUAL signals, never an aggregate: every entry carries its own value, `source` (where OpenShopGraph observed it) and `checked_at` (when). There is deliberately no score, rating, percentage or star value â not even an internally computed one; you are given the raw evidence and judge for yourself. A field with no source or no check timestamp is omitted entirely rather than shipped with a null placeholder. If nothing was measured, the answer is status "no_signals_collected" with an empty list â that means NOTHING IS KNOWN, it is not a score of zero and not a negative verdict. Unknown domains, shops under internal review and measured-but-empty shops are intentionally indistinguishable here. `signal_coverage` describes data completeness, not merchant trustworthiness: `present`/`total` count how many of the (up to 7) signal fields OpenShopGraph was able to deliver for this shop, and `missing` lists the rest, each with a `reason` â `not_collected_yet` (OpenShopGraph has never run that check for this shop) or `pipeline_gap` (the check ran â source and timestamp exist â but produced no usable value, e.g. an IP/ASN lookup that resolves a hosting ISP but not a country). A low `present` count is NOT evidence of a low-quality or risky merchant: it usually just means one of OpenShopGraph's own probes came back empty. Do not treat `signal_coverage` as a rating, and do not rank or filter merchants by it as if it were one. Unlike every other tool on this page, this one requires a valid `x-api-token` header â a call without one fails before reaching this tool (401, no exceptions for anonymous/public callers).
読み取り専用
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['shop_domain'], 'properties': {'shop_domain': {'type': 'string', 'maxLength': 512, 'minLength': 1, 'description': 'Shop domain, e.g. "otto.de". An internal OpenShopGraph shop id is accepted here as well. The older field name `shop_id_or_domain` still works on every tool and means exactly the same thing.'}}, 'additionalProperties': False}
list_categories
Enumerate the shop category taxonomy: every category slug currently carried by at least one public shop, together with how many public shops carry it. Call this BEFORE passing `category` to find_shop â the taxonomy is flat (no parent/child hierarchy, e.g. "fashion" and "womens-clothing" are siblings, not nested) and its slugs come from observed data, not a fixed enum baked into this tool, so a slug cannot be reliably guessed. `find_shop(category: <slug>)` only accepts a slug returned here; giving it anything else fails with an error instead of silently returning no results. Coverage measured 2026-09-03: 171 slugs across 3036 of 3100 active shops (97.9%) â a shop can carry more than one category, so counts do not sum to the total shop count.
読み取り専用
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
list_coupons
List currently USABLE discount codes/coupons, optionally filtered by shop_domain (e.g. "otto.de"). A code is withheld from `results` when it is EXPIRED (valid_until has passed), when a real checkout test PROVED it does not work (verification_status "verified_rejected"), or when a display policy suppresses it on this channel/country. Nothing is withheld silently: `total_count` is how many codes the query found before any of that, and `withheld` breaks the difference down by reason ({expired, verified_rejected, reserved_test_domain, policy}) â total_count minus results.length always equals the sum of `withheld`, and `note` states the same balance in one sentence. So an empty `results` NEVER has to be guessed at: read `total_count` and `note` to tell "this shop has no codes at all" apart from "it has codes and every one of them is proven dead". An UNKNOWN or internal-review shop_domain is a different answer again â it is an error ("shop not found"), not an empty list; and a backend failure is reported as a failure, never as an empty list. Each result carries validUntil: an ISO timestamp when the code has a stated expiry, or null when it is open-ended â null means unlimited, NOT unknown-and-expired. Re-check validUntil against the current time before relaying a code. Each result ALSO carries verificationStatus, the verdict of a real checkout test against this exact code: "verified_applied" means the code was proven to work by an actual checkout attempt with proof on file â safe to recommend; "unverified" means no proof exists either way yet â treat it as unknown, NOT as a negative signal, and do not imply it was tested and failed. ("verified_rejected" is defined as before but no longer appears in `results` â it is counted in `withheld.verified_rejected` instead.) lastVerifiedAt is the ISO timestamp of that most recent test, or null if the code was never tested. A non-null lastVerifiedAt on an "unverified" code means it WAS tested but the test was inconclusive â it is not the same as a code that was never attempted.
読み取り専用
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'shop_domain': {'type': 'string', 'maxLength': 512}}, 'additionalProperties': False}
report_code
Record that a specific shop_domain + code (coupon) pair is wrong in one of four fixed, documented ways (invalid | mismatch | item_restricted | min_order_missing â see reasons enum; no free text anywhere). This is a write: it appends one new report row and NEVER changes the delivered coupon directly â it never deletes or overwrites data, and it does not itself decide anything. Subject to per-source dedup it only queues a re-check (RecheckQueueEntry); only a separate Pruefurteil process may later change what list_coupons returns. Reply is a status text ('wird gemeldet, Pruefung laeuft'), never a verdict.
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['shop_domain', 'code', 'reason'], 'properties': {'code': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'reason': {'enum': ['invalid', 'mismatch', 'item_restricted', 'min_order_missing'], 'type': 'string'}, 'shop_domain': {'type': 'string', 'maxLength': 253, 'minLength': 1}}, 'additionalProperties': False}
report_issue
Record a shop-level or data-fact issue as one fixed, documented reason (no free text). subject_type "shop": unreachable | no_longer_exists | info_outdated | wrong_category | wrong_name_or_domain. subject_type "fact": shipping_cost | return_period | payment_methods | evidence_broken. Same write semantics as report_code: appends one report row, never changes delivered data directly, only queues a re-check subject to per-source dedup.
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subject_type', 'shop_domain', 'reason'], 'properties': {'reason': {'enum': ['unreachable', 'no_longer_exists', 'info_outdated', 'wrong_category', 'wrong_name_or_domain', 'shipping_cost', 'return_period', 'payment_methods', 'evidence_broken'], 'type': 'string'}, 'shop_domain': {'type': 'string', 'maxLength': 253, 'minLength': 1}, 'subject_type': {'enum': ['shop', 'fact'], 'type': 'string'}}, 'additionalProperties': False}
履歴
最近のツール変更
追加
report_issue
2026年9月17日12:36
追加
report_code
2026年9月17日12:36
追加
get_trust
2026年9月17日12:36
追加
get_shipping_policy
2026年9月17日12:36
追加
list_coupons
2026年9月17日12:36
追加
get_shop
2026年9月17日12:36
追加
list_categories
2026年9月17日12:36
追加
find_shop
2026年9月17日12:36
関連MCP
類似のMCPサーバー
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Bonanza
io.github.pipeworx-io/bonanza
Searches active Bonanza marketplace listings and retrieves individual item details.
cyclesite-mcp-server
io.github.Tomalarrrr/cyclesite-mcp-server
Supports searching, comparing, valuing, buying, selling, reserving, and messaging about used bicycles on a UK marketplace.
MONO Social
io.github.junoventures/mono-juno-ventures
Provides directory search for local places, events, listings, services, offers, bookings, reservations, tickets, and products.
Campo Belo
io.github.junoventures/campobelo-sampa-br
Provides Campo Belo local discovery for places, events, menus, offers, services, bookings, reservations, tickets, and purchases.
Bom Retiro
io.github.junoventures/bomretiro-sampa-br
Provides Bom Retiro local place, event, menu, offer, service, booking, reservation, ticketing, and checkout capabilities.
Bogeyland
io.github.junoventures/bogeyland-golf
Provides directory search for places, events, services, offers, bookings, reservations, tickets, menus, and purchases.
Genesis Social
io.github.junoventures/genesis-social
Provides directory search and transactions for local places, events, restaurants, services, offers, bookings, and tickets.