MCPサーバー

Loppee

com.loppee/loppee
ビジネス・業務 公開・接続可能 MCP 2025-11-25

このMCPでできること

Looks up businesses, trust cards, public reviews, recommendations, and side-by-side comparisons from a business trust registry.

compare_businesses
Compare Businesses
Use this when the user wants a side-by-side comparison of two to twenty known published Loppee business ids. Returns each business's exact class, disclosure, review context, and citation; unknown or unavailable ids are listed as unresolved rather than fabricated.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['business_ids'], 'properties': {'business_ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 20, 'minItems': 2, 'description': 'Two to twenty Loppee business ids to compare. Duplicates are de-duplicated.'}}}
出力スキーマ
{'type': 'object', 'oneOf': [{'not': {'required': ['error']}, 'required': ['ok', 'data'], 'properties': {'ok': {'const': True}}}, {'not': {'required': ['data']}, 'required': ['ok', 'error'], 'properties': {'ok': {'const': False}}}], '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contract_version', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'data': {'type': 'object', 'required': ['endpoint', 'ordering', 'comparison_neutrality', 'requested_count', 'compared_count', 'comparisons', 'unresolved_business_ids'], 'properties': {'endpoint': {'type': 'string', 'const': 'compare_businesses'}, 'ordering': {'type': 'string'}, 'comparisons': {'type': 'array', 'items': {'type': 'object', 'required': ['business_id', 'display_name', 'category', 'verification_class', 'verification_disclosure', 'trust_card_url', 'public_profile_url'], 'properties': {'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'website': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'type': 'string'}, 'insurance': {'type': 'object', 'required': ['status', 'carrier_name', 'stated_expires_at', 'disclosure'], 'properties': {'status': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'carrier_name': {'type': 'string'}, 'stated_expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'business_id': {'type': 'string'}, 'display_name': {'type': 'string'}, 'trust_card_url': {'type': 'string'}, 'review_reputation': {'type': 'object', 'required': ['display_rating', 'display_review_count', 'ranking'], 'properties': {'ranking': {'type': 'object', 'required': ['status', 'basis', 'half_star_band'], 'properties': {'basis': {'type': 'string'}, 'status': {'type': 'string'}, 'half_star_band': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'reviews_url': {'type': 'string'}, 'display_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'quality_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'counts_truncated': {'type': 'boolean'}, 'display_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'latest_review_snippet': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'identity_verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'public_profile_url': {'type': 'string'}, 'verification_class': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'verification_disclosure': {'type': 'string'}}, 'additionalProperties': False}}, 'compared_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'schema_version': {'type': 'string'}, 'requested_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'trust_model_version': {'type': 'string'}, 'comparison_neutrality': {'type': 'string', 'const': 'Comparison order is neutral and based only on public business trust and review facts.'}, 'unresolved_business_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'status': {'type': 'integer', 'maximum': 599, 'minimum': 400}, 'message': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'contract_version': {'type': 'string', 'const': '1.0'}}, 'additionalProperties': False}
explain_recommendation
Explain Recommendation
Use this when the user asks why a known published business is or is not recommendable on Loppee. Returns the published class, disclosure, recommendation basis, commercial-neutrality statement, and citation without exposing private weighting.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['business_id'], 'properties': {'business_id': {'type': 'string', 'minLength': 1, 'description': 'Loppee business id of a published Trust Card.'}}}
出力スキーマ
{'type': 'object', 'oneOf': [{'not': {'required': ['error']}, 'required': ['ok', 'data'], 'properties': {'ok': {'const': True}}}, {'not': {'required': ['data']}, 'required': ['ok', 'error'], 'properties': {'ok': {'const': False}}}], '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contract_version', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'data': {'type': 'object', 'required': ['endpoint', 'business_id', 'display_name', 'verification_class', 'verification_disclosure', 'decision', 'basis', 'recommendation_order', 'commercial_influence', 'citation', 'trust_card_url', 'public_profile_url'], 'properties': {'basis': {'type': 'string'}, 'citation': {'type': 'object', 'required': ['registry', 'url'], 'properties': {'url': {'type': 'string'}, 'registry': {'type': 'string'}}, 'additionalProperties': False}, 'decision': {'type': 'string'}, 'endpoint': {'type': 'string', 'const': 'explain_recommendation'}, 'business_id': {'type': 'string'}, 'display_name': {'type': 'string'}, 'registry_name': {'type': 'string'}, 'schema_version': {'type': 'string'}, 'trust_card_url': {'type': 'string'}, 'public_profile_url': {'type': 'string'}, 'verification_class': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'commercial_influence': {'type': 'string', 'const': 'none'}, 'recommendation_order': {'type': 'string'}, 'verification_disclosure': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'status': {'type': 'integer', 'maximum': 599, 'minimum': 400}, 'message': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'contract_version': {'type': 'string', 'const': '1.0'}}, 'additionalProperties': False}
get_business_reviews
Get Business Reviews (paginated)
Use this when the user wants the public customer reviews for one Loppee business id. Supports pagination and star-rating filters, preserves reviewer and interaction labels, masks reviewer identity, and changes nothing.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['business_id'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number (default 1).'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Reviews per page (default 5, max 50).'}, 'ratings': {'type': 'array', 'items': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'description': 'Star-rating filter: return only reviews with these ratings, e.g. [1] or [4,5]. Omit for all ratings.'}, 'business_id': {'type': 'string', 'minLength': 1, 'description': 'Loppee business id of a published business.'}}}
出力スキーマ
{'type': 'object', 'oneOf': [{'not': {'required': ['error']}, 'required': ['ok', 'data'], 'properties': {'ok': {'const': True}}}, {'not': {'required': ['data']}, 'required': ['ok', 'error'], 'properties': {'ok': {'const': False}}}], '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contract_version', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'data': {'type': 'object', 'required': ['business_id', 'display_name', 'sort', 'filter', 'summary', 'reviews', 'pagination'], 'properties': {'sort': {'type': 'string'}, 'filter': {'type': 'object', 'required': ['ratings'], 'properties': {'ratings': {'anyOf': [{'type': 'array', 'items': {'type': 'integer', 'maximum': 5, 'minimum': 1}}, {'type': 'null'}]}}, 'additionalProperties': False}, 'reviews': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'rating', 'title', 'body', 'reviewer_name', 'relationship', 'service_date', 'created_at', 'authoring_mode', 'agent_assisted', 'owner_response'], 'properties': {'id': {'type': 'string'}, 'body': {'type': 'string'}, 'title': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'created_at': {'type': 'string'}, 'relationship': {'type': 'string'}, 'service_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reviewer_name': {'type': 'string'}, 'agent_assisted': {'type': 'boolean'}, 'authoring_mode': {'type': 'string'}, 'owner_response': {'anyOf': [{'type': 'object', 'required': ['body', 'author_label', 'created_at'], 'properties': {'body': {'type': 'string'}, 'created_at': {'type': 'string'}, 'author_label': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'verification_label': {'type': 'string'}, 'reviewer_verification_label': {'type': 'string'}, 'reviewer_verification_disclosure': {'type': 'string'}}, 'additionalProperties': False}}, 'summary': {'type': 'object', 'required': ['average_rating', 'review_count', 'rating_counts', 'ranking'], 'properties': {'ranking': {'type': 'object', 'required': ['status', 'basis', 'half_star_band'], 'properties': {'basis': {'type': 'string'}, 'status': {'type': 'string'}, 'half_star_band': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'rating_counts': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'average_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'quality_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'counts_truncated': {'type': 'boolean'}, 'verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'identity_verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'pagination': {'type': 'object', 'required': ['page', 'limit', 'total_count', 'total_pages', 'has_more', 'next_page'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'limit': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'has_more': {'type': 'boolean'}, 'next_page': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, {'type': 'null'}]}, 'total_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'total_pages': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'business_id': {'type': 'string'}, 'display_name': {'type': 'string'}, 'registry_name': {'type': 'string'}, 'schema_version': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'registry_page_notice': {'type': 'string'}, 'business_claim_status': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'status': {'type': 'integer', 'maximum': 599, 'minimum': 400}, 'message': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'contract_version': {'type': 'string', 'const': '1.0'}}, 'additionalProperties': False}
get_trust_card
Get Trust Card
Use this when a business is already identified and the user wants its public Loppee Trust Card. Returns the exact business status, disclosure, coarse public city/state, public facts, review context, and citation without account authority, street address, ZIP, or signed media links.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'domain_key': {'type': 'string', 'description': 'Normalized domain key such as example-com.'}, 'business_id': {'type': 'string', 'description': 'Loppee business id.'}}}
出力スキーマ
{'type': 'object', 'oneOf': [{'not': {'required': ['error']}, 'required': ['ok', 'data'], 'properties': {'ok': {'const': True}}}, {'not': {'required': ['data']}, 'required': ['ok', 'error'], 'properties': {'ok': {'const': False}}}], '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contract_version', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'data': {'anyOf': [{'type': 'object', 'required': ['business_id', 'display_name', 'category', 'services', 'reviews'], 'properties': {'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'hours': {'anyOf': [{'type': 'object', 'required': ['weekly', 'overrides'], 'properties': {'weekly': {'type': 'object', 'properties': {'fri': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'mon': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'sat': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'sun': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'thu': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'tue': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'wed': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'overrides': {'type': 'array', 'items': {'type': 'object', 'required': ['status', 'ranges', 'date', 'label'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, {'type': 'null'}]}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reviews': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'rating', 'title', 'body', 'reviewer_name', 'relationship', 'service_date', 'created_at', 'authoring_mode', 'agent_assisted', 'owner_response'], 'properties': {'id': {'type': 'string'}, 'body': {'type': 'string'}, 'title': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'created_at': {'type': 'string'}, 'relationship': {'type': 'string'}, 'service_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reviewer_name': {'type': 'string'}, 'agent_assisted': {'type': 'boolean'}, 'authoring_mode': {'type': 'string'}, 'owner_response': {'anyOf': [{'type': 'object', 'required': ['body', 'author_label', 'created_at'], 'properties': {'body': {'type': 'string'}, 'created_at': {'type': 'string'}, 'author_label': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'verification_label': {'type': 'string'}, 'reviewer_verification_label': {'type': 'string'}, 'reviewer_verification_disclosure': {'type': 'string'}}, 'additionalProperties': False}}, 'website': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'type': 'array', 'items': {'type': 'string'}}, 'citation': {'type': 'object', 'required': ['registry', 'url'], 'properties': {'url': {'type': 'string'}, 'registry': {'type': 'string'}}, 'additionalProperties': False}, 'services': {'type': 'array', 'items': {'type': 'string'}}, 'insurance': {'type': 'object', 'required': ['status', 'carrier_name', 'stated_expires_at', 'disclosure'], 'properties': {'status': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'carrier_name': {'type': 'string'}, 'stated_expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'disclosure': {'type': 'string'}, 'legal_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'updated_at': {'type': 'string'}, 'business_id': {'type': 'string'}, 'source_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'type': 'string'}, 'claim_status': {'type': 'string'}, 'display_name': {'type': 'string'}, 'subject_kind': {'type': 'string'}, 'registry_name': {'type': 'string'}, 'schema_version': {'type': 'string'}, 'trust_card_url': {'type': 'string'}, 'primary_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'review_reputation': {'type': 'object', 'required': ['display_rating', 'display_review_count', 'ranking'], 'properties': {'ranking': {'type': 'object', 'required': ['status', 'basis', 'half_star_band'], 'properties': {'basis': {'type': 'string'}, 'status': {'type': 'string'}, 'half_star_band': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'reviews_url': {'type': 'string'}, 'display_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'quality_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'counts_truncated': {'type': 'boolean'}, 'display_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'latest_review_snippet': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'identity_verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'public_profile_url': {'type': 'string'}, 'verification_class': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'verification_disclosure': {'type': 'string'}, 'verification_valid_until': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['business_id', 'domain', 'trust_card'], 'properties': {'domain': {'type': 'string'}, 'trust_card': {'type': 'object', 'required': ['business_id', 'display_name', 'category', 'services', 'reviews'], 'properties': {'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'hours': {'anyOf': [{'type': 'object', 'required': ['weekly', 'overrides'], 'properties': {'weekly': {'type': 'object', 'properties': {'fri': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'mon': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'sat': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'sun': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'thu': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'tue': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}, 'wed': {'type': 'object', 'required': ['status', 'ranges'], 'properties': {'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'overrides': {'type': 'array', 'items': {'type': 'object', 'required': ['status', 'ranges', 'date', 'label'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'ranges': {'type': 'array', 'items': {'type': 'object', 'required': ['open', 'close'], 'properties': {'open': {'type': 'string'}, 'close': {'type': 'string'}}, 'additionalProperties': False}}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, {'type': 'null'}]}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reviews': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'rating', 'title', 'body', 'reviewer_name', 'relationship', 'service_date', 'created_at', 'authoring_mode', 'agent_assisted', 'owner_response'], 'properties': {'id': {'type': 'string'}, 'body': {'type': 'string'}, 'title': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'created_at': {'type': 'string'}, 'relationship': {'type': 'string'}, 'service_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reviewer_name': {'type': 'string'}, 'agent_assisted': {'type': 'boolean'}, 'authoring_mode': {'type': 'string'}, 'owner_response': {'anyOf': [{'type': 'object', 'required': ['body', 'author_label', 'created_at'], 'properties': {'body': {'type': 'string'}, 'created_at': {'type': 'string'}, 'author_label': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'verification_label': {'type': 'string'}, 'reviewer_verification_label': {'type': 'string'}, 'reviewer_verification_disclosure': {'type': 'string'}}, 'additionalProperties': False}}, 'website': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'type': 'array', 'items': {'type': 'string'}}, 'citation': {'type': 'object', 'required': ['registry', 'url'], 'properties': {'url': {'type': 'string'}, 'registry': {'type': 'string'}}, 'additionalProperties': False}, 'services': {'type': 'array', 'items': {'type': 'string'}}, 'insurance': {'type': 'object', 'required': ['status', 'carrier_name', 'stated_expires_at', 'disclosure'], 'properties': {'status': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'carrier_name': {'type': 'string'}, 'stated_expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'disclosure': {'type': 'string'}, 'legal_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'updated_at': {'type': 'string'}, 'business_id': {'type': 'string'}, 'source_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'type': 'string'}, 'claim_status': {'type': 'string'}, 'display_name': {'type': 'string'}, 'subject_kind': {'type': 'string'}, 'registry_name': {'type': 'string'}, 'schema_version': {'type': 'string'}, 'trust_card_url': {'type': 'string'}, 'primary_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'review_reputation': {'type': 'object', 'required': ['display_rating', 'display_review_count', 'ranking'], 'properties': {'ranking': {'type': 'object', 'required': ['status', 'basis', 'half_star_band'], 'properties': {'basis': {'type': 'string'}, 'status': {'type': 'string'}, 'half_star_band': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'reviews_url': {'type': 'string'}, 'display_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'quality_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'counts_truncated': {'type': 'boolean'}, 'display_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'latest_review_snippet': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'identity_verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'public_profile_url': {'type': 'string'}, 'verification_class': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'verification_disclosure': {'type': 'string'}, 'verification_valid_until': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'business_id': {'type': 'string'}, 'schema_version': {'type': 'string'}, 'trust_card_url': {'type': 'string'}, 'verification_class': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'verification_disclosure': {'type': 'string'}}, 'additionalProperties': False}]}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'status': {'type': 'integer', 'maximum': 599, 'minimum': 400}, 'message': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'contract_version': {'type': 'string', 'const': '1.0'}}, 'additionalProperties': False}
lookup_business
Lookup Business
Use this when the user names a business and wants its Loppee Registry match. Returns exact and genuine-prefix name matches with stable ids, coarse public city/state, and truthful Verified, Listed, or Registry disclosure. It does not perform category discovery, accept or return caller location, or return a street address or ZIP.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Business name to look up through the universal, pay-independent name lane.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum result count from 1 to 50.'}, 'cursor': {'type': 'string', 'maxLength': 4096, 'minLength': 1, 'description': 'Opaque cursor returned in next_cursor by the previous v3 search page. Omit for the first page.'}}}
出力スキーマ
{'type': 'object', 'oneOf': [{'not': {'required': ['error']}, 'required': ['ok', 'data'], 'properties': {'ok': {'const': True}}}, {'not': {'required': ['data']}, 'required': ['ok', 'error'], 'properties': {'ok': {'const': False}}}], '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contract_version', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'data': {'type': 'object', 'required': ['has_more', 'returned_count', 'results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['display_name'], 'properties': {'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'website': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'type': 'string'}, 'open_now': {'anyOf': [{'type': 'object', 'required': ['status', 'is_open', 'label', 'detail', 'closes_at', 'opens_at', 'override_label', 'time_zone', 'local_time'], 'properties': {'label': {'type': 'string'}, 'detail': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'status': {'enum': ['open', 'closed', 'open_24', 'appointment'], 'type': 'string'}, 'is_open': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'opens_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'closes_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'time_zone': {'type': 'string'}, 'local_time': {'type': 'string'}, 'override_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'insurance': {'type': 'object', 'required': ['status', 'carrier_name', 'stated_expires_at', 'disclosure'], 'properties': {'status': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'carrier_name': {'type': 'string'}, 'stated_expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'disclosure': {'type': 'string'}, 'listing_id': {'type': 'string'}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'business_id': {'type': 'string'}, 'source_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'type': 'string'}, 'claim_status': {'type': 'string'}, 'display_name': {'type': 'string'}, 'subject_kind': {'type': 'string'}, 'trust_card_url': {'type': 'string'}, 'review_reputation': {'type': 'object', 'required': ['display_rating', 'display_review_count', 'ranking'], 'properties': {'ranking': {'type': 'object', 'required': ['status', 'basis', 'half_star_band'], 'properties': {'basis': {'type': 'string'}, 'status': {'type': 'string'}, 'half_star_band': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'reviews_url': {'type': 'string'}, 'display_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'quality_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'counts_truncated': {'type': 'boolean'}, 'display_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'latest_review_snippet': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'identity_verified_review_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'public_profile_url': {'type': 'string'}, 'verification_class': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'verification_disclosure': {'type': 'string'}}, 'additionalProperties': False}}, 'has_more': {'type': 'boolean'}, 'page_limit': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'generated_at': {'type': 'string'}, 'display_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'registry_name': {'type': 'string'}, 'total_matches': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'returned_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'schema_version': {'type': 'string'}, 'total_matches_basis': {'type': 'string'}, 'trust_model_version': {'type': 'string'}, 'registry_count_basis': {'type': 'string'}, 'presentation_guidance': {'type': 'string'}, 'total_registry_records': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'visible_candidate_records': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'candidate_window_truncated': {'type': 'boolean'}, 'registry_count_observed_at': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'status': {'type': 'integer', 'maximum': 599, 'minimum': 400}, 'message': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'contract_version': {'type': 'string', 'const': '1.0'}}, 'additionalProperties': False}
変更
lookup_business
2026年10月1日2:53
変更
lookup_business
2026年9月29日3:02
追加
compare_businesses
2026年9月17日12:36
追加
explain_recommendation
2026年9月17日12:36
追加
get_business_reviews
2026年9月17日12:36
追加
get_trust_card
2026年9月17日12:36
追加
lookup_business
2026年9月17日12:36