Loppee
Agent-first US business trust registry with neutral Trust Cards and published evidence.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"loppee": {
"url": "https://loppee.com/mcp"
}
}
}원격 엔드포인트
https://loppee.com/mcpstreamable-httphttps://loppee.com/mcp/discoverystreamable-http할 수 있는 일
도구 목록
도구 (5)
🟢lookup_business(name, cursor, limit)
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",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Business name to look up through the universal, pay-independent name lane."
},
"cursor": {
"description": "Opaque cursor returned in next_cursor by the previous v3 search page. Omit for the first page.",
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"limit": {
"default": 10,
"description": "Maximum result count from 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"name"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.0"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"total_registry_records": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"registry_count_basis": {
"type": "string"
},
"registry_count_observed_at": {
"type": "string"
},
"visible_candidate_records": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"total_matches": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"total_matches_basis": {
"type": "string"
},
"candidate_window_truncated": {
"type": "boolean"
},
"has_more": {
"type": "boolean"
},
"returned_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"page_limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source_type": {
"type": "string"
},
"listing_id": {
"type": "string"
},
"business_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"trust_model_version": {
"type": "string"
},
"subject_kind": {
"type": "string"
},
"claim_status": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"review_reputation": {
"type": "object",
"properties": {
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"display_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"identity_verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ranking": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"basis": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"basis",
"half_star_band"
],
"additionalProperties": false
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"reviews_url": {
"type": "string"
}
},
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"additionalProperties": false
},
"trust_card_url": {
"type": "string"
},
"public_profile_url": {
"type": "string"
},
"insurance": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"disclosure": {
"type": "string"
}
},
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"additionalProperties": false
},
"open_now": {
"anyOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"is_open": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"label": {
"type": "string"
},
"detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"closes_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"opens_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"override_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"time_zone": {
"type": "string"
},
"local_time": {
"type": "string"
}
},
"required": [
"status",
"is_open",
"label",
"detail",
"closes_at",
"opens_at",
"override_label",
"time_zone",
"local_time"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"display_name"
],
"additionalProperties": false
}
}
},
"required": [
"total_matches",
"has_more",
"returned_count",
"results"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"message": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"minimum": 400,
"maximum": 599
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"contract_version",
"ok"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"oneOf": [
{
"properties": {
"ok": {
"const": true
}
},
"required": [
"ok",
"data"
],
"not": {
"required": [
"error"
]
}
},
{
"properties": {
"ok": {
"const": false
}
},
"required": [
"ok",
"error"
],
"not": {
"required": [
"data"
]
}
}
]
}🟢get_trust_card(business_id, domain_key)
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",
"properties": {
"business_id": {
"description": "Loppee business id.",
"type": "string"
},
"domain_key": {
"description": "Normalized domain key such as example-com.",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.0"
},
"ok": {
"type": "boolean"
},
"data": {
"anyOf": [
{
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"business_id": {
"type": "string"
},
"legal_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"display_name": {
"type": "string"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"primary_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "array",
"items": {
"type": "string"
}
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"services": {
"type": "array",
"items": {
"type": "string"
}
},
"hours": {
"anyOf": [
{
"type": "object",
"properties": {
"version": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"weekly": {
"type": "object",
"properties": {
"mon": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"tue": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"wed": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"thu": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"fri": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"sat": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"sun": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
},
"date": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"status",
"ranges",
"date",
"label"
],
"additionalProperties": false
}
}
},
"required": [
"weekly",
"overrides"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"review_reputation": {
"type": "object",
"properties": {
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"display_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"identity_verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ranking": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"basis": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"basis",
"half_star_band"
],
"additionalProperties": false
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"reviews_url": {
"type": "string"
}
},
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"additionalProperties": false
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"rating": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"title": {
"type": "string"
},
"body": {
"type": "string"
},
"reviewer_name": {
"type": "string"
},
"relationship": {
"type": "string"
},
"service_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"verification_label": {
"type": "string"
},
"reviewer_verification_label": {
"type": "string"
},
"reviewer_verification_disclosure": {
"type": "string"
},
"authoring_mode": {
"type": "string"
},
"agent_assisted": {
"type": "boolean"
},
"owner_response": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": "string"
},
"author_label": {
"type": "string"
},
"created_at": {
"type": "string"
}
},
"required": [
"body",
"author_label",
"created_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"rating",
"title",
"body",
"reviewer_name",
"relationship",
"service_date",
"created_at",
"authoring_mode",
"agent_assisted",
"owner_response"
],
"additionalProperties": false
}
},
"insurance": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"disclosure": {
"type": "string"
}
},
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"additionalProperties": false
},
"source_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verification_valid_until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"subject_kind": {
"type": "string"
},
"source_type": {
"type": "string"
},
"claim_status": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"citation": {
"type": "object",
"properties": {
"registry": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"registry",
"url"
],
"additionalProperties": false
},
"trust_card_url": {
"type": "string"
},
"public_profile_url": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"required": [
"business_id",
"display_name",
"category",
"services",
"reviews"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"business_id": {
"type": "string"
},
"domain": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"trust_card_url": {
"type": "string"
},
"trust_card": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"business_id": {
"type": "string"
},
"legal_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"display_name": {
"type": "string"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"primary_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "array",
"items": {
"type": "string"
}
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"services": {
"type": "array",
"items": {
"type": "string"
}
},
"hours": {
"anyOf": [
{
"type": "object",
"properties": {
"version": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"weekly": {
"type": "object",
"properties": {
"mon": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"tue": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"wed": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"thu": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"fri": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"sat": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
},
"sun": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"ranges"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"open_24",
"appointment"
]
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open": {
"type": "string"
},
"close": {
"type": "string"
}
},
"required": [
"open",
"close"
],
"additionalProperties": false
}
},
"date": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"status",
"ranges",
"date",
"label"
],
"additionalProperties": false
}
}
},
"required": [
"weekly",
"overrides"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"review_reputation": {
"type": "object",
"properties": {
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"display_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"identity_verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ranking": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"basis": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"basis",
"half_star_band"
],
"additionalProperties": false
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"reviews_url": {
"type": "string"
}
},
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"additionalProperties": false
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"rating": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"title": {
"type": "string"
},
"body": {
"type": "string"
},
"reviewer_name": {
"type": "string"
},
"relationship": {
"type": "string"
},
"service_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"verification_label": {
"type": "string"
},
"reviewer_verification_label": {
"type": "string"
},
"reviewer_verification_disclosure": {
"type": "string"
},
"authoring_mode": {
"type": "string"
},
"agent_assisted": {
"type": "boolean"
},
"owner_response": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": "string"
},
"author_label": {
"type": "string"
},
"created_at": {
"type": "string"
}
},
"required": [
"body",
"author_label",
"created_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"rating",
"title",
"body",
"reviewer_name",
"relationship",
"service_date",
"created_at",
"authoring_mode",
"agent_assisted",
"owner_response"
],
"additionalProperties": false
}
},
"insurance": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"disclosure": {
"type": "string"
}
},
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"additionalProperties": false
},
"source_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verification_valid_until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"subject_kind": {
"type": "string"
},
"source_type": {
"type": "string"
},
"claim_status": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"citation": {
"type": "object",
"properties": {
"registry": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"registry",
"url"
],
"additionalProperties": false
},
"trust_card_url": {
"type": "string"
},
"public_profile_url": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"required": [
"business_id",
"display_name",
"category",
"services",
"reviews"
],
"additionalProperties": false
}
},
"required": [
"business_id",
"domain",
"trust_card"
],
"additionalProperties": false
}
]
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"message": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"minimum": 400,
"maximum": 599
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"contract_version",
"ok"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"oneOf": [
{
"properties": {
"ok": {
"const": true
}
},
"required": [
"ok",
"data"
],
"not": {
"required": [
"error"
]
}
},
{
"properties": {
"ok": {
"const": false
}
},
"required": [
"ok",
"error"
],
"not": {
"required": [
"data"
]
}
}
]
}🟢get_business_reviews(business_id, page, limit, ratings)
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",
"properties": {
"business_id": {
"type": "string",
"minLength": 1,
"description": "Loppee business id of a published business."
},
"page": {
"description": "1-based page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Reviews per page (default 5, max 50).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"ratings": {
"description": "Star-rating filter: return only reviews with these ratings, e.g. [1] or [4,5]. Omit for all ratings.",
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 5
}
}
},
"required": [
"business_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.0"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"business_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"business_claim_status": {
"type": "string"
},
"registry_page_notice": {
"type": "string"
},
"sort": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"ratings": {
"anyOf": [
{
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 5
}
},
{
"type": "null"
}
]
}
},
"required": [
"ratings"
],
"additionalProperties": false
},
"summary": {
"type": "object",
"properties": {
"average_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"identity_verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rating_counts": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"ranking": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"basis": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"basis",
"half_star_band"
],
"additionalProperties": false
},
"counts_truncated": {
"type": "boolean"
}
},
"required": [
"average_rating",
"review_count",
"rating_counts",
"ranking"
],
"additionalProperties": false
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"rating": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"title": {
"type": "string"
},
"body": {
"type": "string"
},
"reviewer_name": {
"type": "string"
},
"relationship": {
"type": "string"
},
"service_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"verification_label": {
"type": "string"
},
"reviewer_verification_label": {
"type": "string"
},
"reviewer_verification_disclosure": {
"type": "string"
},
"authoring_mode": {
"type": "string"
},
"agent_assisted": {
"type": "boolean"
},
"owner_response": {
"anyOf": [
{
"type": "object",
"properties": {
"body": {
"type": "string"
},
"author_label": {
"type": "string"
},
"created_at": {
"type": "string"
}
},
"required": [
"body",
"author_label",
"created_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"rating",
"title",
"body",
"reviewer_name",
"relationship",
"service_date",
"created_at",
"authoring_mode",
"agent_assisted",
"owner_response"
],
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"total_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"total_pages": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"has_more": {
"type": "boolean"
},
"next_page": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"limit",
"total_count",
"total_pages",
"has_more",
"next_page"
],
"additionalProperties": false
}
},
"required": [
"business_id",
"display_name",
"sort",
"filter",
"summary",
"reviews",
"pagination"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"message": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"minimum": 400,
"maximum": 599
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"contract_version",
"ok"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"oneOf": [
{
"properties": {
"ok": {
"const": true
}
},
"required": [
"ok",
"data"
],
"not": {
"required": [
"error"
]
}
},
{
"properties": {
"ok": {
"const": false
}
},
"required": [
"ok",
"error"
],
"not": {
"required": [
"data"
]
}
}
]
}🟢explain_recommendation(business_id)
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",
"properties": {
"business_id": {
"type": "string",
"minLength": 1,
"description": "Loppee business id of a published Trust Card."
}
},
"required": [
"business_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.0"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"registry_name": {
"type": "string"
},
"endpoint": {
"type": "string",
"const": "explain_recommendation"
},
"business_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"decision": {
"type": "string"
},
"basis": {
"type": "string"
},
"recommendation_order": {
"type": "string"
},
"commercial_influence": {
"type": "string",
"const": "none"
},
"citation": {
"type": "object",
"properties": {
"registry": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"registry",
"url"
],
"additionalProperties": false
},
"trust_card_url": {
"type": "string"
},
"public_profile_url": {
"type": "string"
}
},
"required": [
"endpoint",
"business_id",
"display_name",
"verification_class",
"verification_disclosure",
"decision",
"basis",
"recommendation_order",
"commercial_influence",
"citation",
"trust_card_url",
"public_profile_url"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"message": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"minimum": 400,
"maximum": 599
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"contract_version",
"ok"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"oneOf": [
{
"properties": {
"ok": {
"const": true
}
},
"required": [
"ok",
"data"
],
"not": {
"required": [
"error"
]
}
},
{
"properties": {
"ok": {
"const": false
}
},
"required": [
"ok",
"error"
],
"not": {
"required": [
"data"
]
}
}
]
}🟢compare_businesses(business_ids)
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",
"properties": {
"business_ids": {
"minItems": 2,
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Two to twenty Loppee business ids to compare. Duplicates are de-duplicated."
}
},
"required": [
"business_ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "1.0"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"trust_model_version": {
"type": "string"
},
"endpoint": {
"type": "string",
"const": "compare_businesses"
},
"ordering": {
"type": "string"
},
"comparison_neutrality": {
"type": "string",
"const": "Comparison order is neutral and based only on public business trust and review facts."
},
"requested_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"compared_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"comparisons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"business_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"trust_model_version": {
"type": "string"
},
"verification_class": {
"type": "string"
},
"verification_disclosure": {
"type": "string"
},
"review_reputation": {
"type": "object",
"properties": {
"display_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"display_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"identity_verified_review_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"quality_rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ranking": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"basis": {
"type": "string"
},
"half_star_band": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"basis",
"half_star_band"
],
"additionalProperties": false
},
"latest_review_snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"counts_truncated": {
"type": "boolean"
},
"reviews_url": {
"type": "string"
}
},
"required": [
"display_rating",
"display_review_count",
"ranking"
],
"additionalProperties": false
},
"trust_card_url": {
"type": "string"
},
"public_profile_url": {
"type": "string"
},
"insurance": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"carrier_name": {
"type": "string"
},
"stated_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"disclosure": {
"type": "string"
}
},
"required": [
"status",
"carrier_name",
"stated_expires_at",
"disclosure"
],
"additionalProperties": false
}
},
"required": [
"business_id",
"display_name",
"category",
"verification_class",
"verification_disclosure",
"trust_card_url",
"public_profile_url"
],
"additionalProperties": false
}
},
"unresolved_business_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"endpoint",
"ordering",
"comparison_neutrality",
"requested_count",
"compared_count",
"comparisons",
"unresolved_business_ids"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"message": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"minimum": 400,
"maximum": 599
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"contract_version",
"ok"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"oneOf": [
{
"properties": {
"ok": {
"const": true
}
},
"required": [
"ok",
"data"
],
"not": {
"required": [
"error"
]
}
},
{
"properties": {
"ok": {
"const": false
}
},
"required": [
"ok",
"error"
],
"not": {
"required": [
"data"
]
}
}
]
}커뮤니티
증거