brands
Search brands and find authorized retailers on authorized.by
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"brands": {
"url": "https://app.authorized.by/api/public/mcp"
}
}
}リモートエンドポイント
https://app.authorized.by/api/public/mcpstreamable-httpできること
ツール一覧
ツール（6）
🟢get_brands(search, page, size)
Search brands (manufacturers) registered on authorized.by, or list them all. Read-only. Returns for each brand: id, name, slug, logo and the number of retailers it has authorized. Omit 'search' to retrieve the full index; use 'page' and 'size' to paginate. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.
入力スキーマ
{
"type": "object",
"properties": {
"search": {
"description": "Filter by brand name or alias. Optional.",
"type": "string"
},
"page": {
"description": "Zero-based page number (default 0).",
"type": "integer"
},
"size": {
"description": "Page size (default 500).",
"type": "integer"
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"brands": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"retailer_count": {
"type": "integer",
"description": "Number of retailers currently authorized by this brand on authorized.by."
}
},
"required": [
"id",
"name",
"slug",
"logo",
"retailer_count"
],
"additionalProperties": false
}
},
"meta": {
"type": [
"object",
"null"
],
"properties": {
"total_brands": {
"type": "integer",
"description": "Total number of public brands on authorized.by."
},
"total_retailers": {
"type": "integer",
"description": "Total number of public retailers on authorized.by."
},
"total_connections": {
"type": "integer",
"description": "Total number of active brand-retailer authorizations on authorized.by."
},
"generated_at": {
"type": [
"string",
"null"
],
"description": "Timestamp (ISO 8601) the index was generated."
}
},
"required": [
"total_brands",
"total_retailers",
"total_connections",
"generated_at"
],
"additionalProperties": false,
"description": "Network-wide totals."
},
"pagination": {
"type": [
"object",
"null"
],
"properties": {
"page": {
"type": "integer",
"description": "Zero-based page number of this response."
},
"size": {
"type": "integer",
"description": "Page size used for this response."
},
"total_items": {
"type": "integer",
"description": "Total number of matching entries across all pages."
},
"total_pages": {
"type": "integer",
"description": "Total number of pages."
}
},
"required": [
"page",
"size",
"total_items",
"total_pages"
],
"additionalProperties": false,
"description": "Pagination of this response."
}
},
"required": [
"brands",
"meta",
"pagination"
],
"description": "A page of brands plus network-wide totals and pagination.",
"additionalProperties": false
}🟢get_brand(id_or_alias)
Get the public profile of one brand (manufacturer) on authorized.by. Read-only. Returns categories, website, headquarters country, description, registration date and the number of authorized retailers. Use get_brands first if you only know an approximate name. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.
入力スキーマ
{
"type": "object",
"properties": {
"id_or_alias": {
"description": "Brand numeric ID, slug or alias, e.g. 'deuter' or '16709'.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"website_url": {
"type": [
"string",
"null"
],
"description": "Brand website URL, or null."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name_de": {
"type": [
"string",
"null"
],
"description": "German category name."
},
"name_en": {
"type": [
"string",
"null"
],
"description": "English category name."
}
},
"required": [
"id",
"name_de",
"name_en"
],
"additionalProperties": false
},
"description": "Product categories."
},
"retailer_count": {
"type": "integer",
"description": "Number of retailers currently authorized by this brand on authorized.by."
},
"product_count": {
"type": "integer",
"description": "Number of products registered on authorized.by; null when unknown."
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"object",
"null"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"required": [
"de",
"en"
],
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null."
},
"hq_country": {
"type": [
"string",
"null"
],
"description": "Headquarters country code, or null."
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
},
"social": {
"type": [
"object",
"null"
],
"properties": {
"instagram": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"additionalProperties": false,
"description": "Social media profile URLs; each may be null."
}
},
"required": [
"description",
"hq_country",
"registration_date",
"social"
],
"additionalProperties": false,
"description": "Extended profile details."
}
},
"required": [
"id",
"name",
"slug",
"website_url",
"logo",
"categories",
"retailer_count",
"product_count",
"details"
],
"description": "The public profile of one brand.",
"additionalProperties": false
}🟢get_brand_retailers(id_or_alias)
List all retailers (shops) currently authorized by a brand on authorized.by. Read-only. Use this to answer 'is shop X an authorized retailer of brand Y?'. Sorted by subscription plan (PREMIUM, then START, then FREE) and then by brand-connection count descending. Each retailer includes shop_url, seal_implemented (whether the authorized.by seal is live on their shop), official_shop, partnership_date, and certificate_url / certificate_url_de: links to the public authorized.by certificate page (English / German) proving this specific brand-retailer authorization. Share the certificate link when a user needs verifiable proof. Only active partnerships are returned: confirmed by both the brand and the retailer, with both profiles public and the brand approved by authorized.by. Revoked or pending partnerships are never listed. Responses are cached and refreshed when the underlying profile or partnership changes, so a revocation may take a short time to disappear. partnership_date is the date the authorization STARTED, not the date it was last verified; a partnership listed here is currently active as of the response time. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.
入力スキーマ
{
"type": "object",
"properties": {
"id_or_alias": {
"description": "Brand numeric ID, slug or alias.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"brand_id": {
"type": "integer",
"description": "Numeric ID of the brand the list belongs to."
},
"total": {
"type": "integer",
"description": "Number of entries in the list."
},
"premium_count": {
"type": "integer",
"description": "Number of listed retailers on the PREMIUM plan."
},
"tuv_certified_count": {
"type": "integer",
"description": "Number of listed retailers with a TÜV certification."
},
"retailers": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"shop_url": {
"type": [
"string",
"null"
],
"description": "Retailer online-shop URL, or null."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"plan": {
"type": [
"string",
"null"
],
"description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE."
},
"tuv_certified": {
"type": "boolean",
"description": "Whether the retailer holds a TÜV certification via authorized.by."
},
"seal_implemented": {
"type": "boolean",
"description": "Whether the authorized.by seal is live on the retailer's shop."
},
"official_shop": {
"type": "boolean",
"description": "Whether this shop is the brand's own official shop."
},
"sponsored": {
"type": "boolean",
"description": "Whether the brand sponsors (highlights) this retailer."
},
"certificate_url": {
"type": [
"string",
"null"
],
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."
},
"certificate_url_de": {
"type": [
"string",
"null"
],
"description": "Same certificate page in German; null when there is no active authorization."
},
"brand_count": {
"type": "integer",
"description": "Number of brands that currently authorize this retailer on authorized.by."
},
"product_count": {
"type": [
"integer",
"null"
],
"description": "Number of products registered on authorized.by; null when unknown."
},
"partnership_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response."
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"opening_hours": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"day_of_week": {
"type": [
"string",
"null"
],
"description": "Day of the week."
},
"opening_hour": {
"type": [
"string",
"null"
],
"description": "Opening time."
},
"closing_hour": {
"type": [
"string",
"null"
],
"description": "Closing time."
}
},
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"additionalProperties": false
},
"description": "Weekly opening hours of the physical store; empty or null when unknown."
},
"payment_methods": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Accepted payment methods; null when unknown."
},
"description": {
"type": [
"object",
"null"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"required": [
"de",
"en"
],
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null."
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"required": [
"de",
"en"
],
"additionalProperties": false
},
"description": "Product categories."
},
"tuv_certification_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified."
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
},
"trustami": {
"type": [
"object",
"null"
],
"properties": {
"rating": {
"type": [
"number",
"null"
],
"description": "Average customer rating, or null."
},
"review_count": {
"type": [
"integer",
"null"
],
"description": "Number of customer reviews, or null."
},
"profile_url": {
"type": [
"string",
"null"
],
"description": "URL of the rating profile, or null."
}
},
"required": [
"rating",
"review_count",
"profile_url"
],
"additionalProperties": false,
"description": "Customer rating from Trustami; fields are null when no rating exists."
},
"social": {
"type": [
"object",
"null"
],
"properties": {
"instagram": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"additionalProperties": false,
"description": "Social media profile URLs; each may be null."
}
},
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"additionalProperties": false,
"description": "Extended profile details."
}
},
"required": [
"id",
"name",
"slug",
"shop_url",
"logo",
"plan",
"tuv_certified",
"seal_implemented",
"official_shop",
"sponsored",
"certificate_url",
"certificate_url_de",
"brand_count",
"product_count",
"partnership_date",
"details"
],
"additionalProperties": false
}
}
},
"required": [
"brand_id",
"total",
"premium_count",
"tuv_certified_count",
"retailers"
],
"description": "All retailers currently authorized by the brand, with per-retailer certificate links.",
"additionalProperties": false
}🟢get_retailers(search, page, size)
Search retailers (shops) registered on authorized.by, or list them all. Read-only. Returns for each retailer: id, name, slug, shop URL, logo, the number of brands that authorized it, and seal_implemented (whether the authorized.by seal is live on their shop). Omit 'search' to retrieve the full index; use 'page' and 'size' to paginate. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.
入力スキーマ
{
"type": "object",
"properties": {
"search": {
"description": "Filter by retailer company name or alias. Optional.",
"type": "string"
},
"page": {
"description": "Zero-based page number (default 0).",
"type": "integer"
},
"size": {
"description": "Page size (default 500).",
"type": "integer"
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"retailers": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"shop_url": {
"type": [
"string",
"null"
],
"description": "Retailer online-shop URL, or null."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"seal_implemented": {
"type": "boolean",
"description": "Whether the authorized.by seal is live on the retailer's shop."
},
"brand_count": {
"type": "integer",
"description": "Number of brands that currently authorize this retailer on authorized.by."
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"opening_hours": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"day_of_week": {
"type": [
"string",
"null"
],
"description": "Day of the week."
},
"opening_hour": {
"type": [
"string",
"null"
],
"description": "Opening time."
},
"closing_hour": {
"type": [
"string",
"null"
],
"description": "Closing time."
}
},
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"additionalProperties": false
},
"description": "Weekly opening hours of the physical store; empty or null when unknown."
},
"payment_methods": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Accepted payment methods; null when unknown."
},
"description": {
"type": [
"object",
"null"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"required": [
"de",
"en"
],
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null."
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"required": [
"de",
"en"
],
"additionalProperties": false
},
"description": "Product categories."
},
"tuv_certification_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified."
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
},
"trustami": {
"type": [
"object",
"null"
],
"properties": {
"rating": {
"type": [
"number",
"null"
],
"description": "Average customer rating, or null."
},
"review_count": {
"type": [
"integer",
"null"
],
"description": "Number of customer reviews, or null."
},
"profile_url": {
"type": [
"string",
"null"
],
"description": "URL of the rating profile, or null."
}
},
"required": [
"rating",
"review_count",
"profile_url"
],
"additionalProperties": false,
"description": "Customer rating from Trustami; fields are null when no rating exists."
},
"social": {
"type": [
"object",
"null"
],
"properties": {
"instagram": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"additionalProperties": false,
"description": "Social media profile URLs; each may be null."
}
},
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"additionalProperties": false,
"description": "Extended profile details."
}
},
"required": [
"id",
"name",
"slug",
"shop_url",
"logo",
"seal_implemented",
"brand_count",
"details"
],
"additionalProperties": false
}
},
"meta": {
"type": [
"object",
"null"
],
"properties": {
"total_brands": {
"type": "integer",
"description": "Total number of public brands on authorized.by."
},
"total_retailers": {
"type": "integer",
"description": "Total number of public retailers on authorized.by."
},
"total_connections": {
"type": "integer",
"description": "Total number of active brand-retailer authorizations on authorized.by."
},
"generated_at": {
"type": [
"string",
"null"
],
"description": "Timestamp (ISO 8601) the index was generated."
}
},
"required": [
"total_brands",
"total_retailers",
"total_connections",
"generated_at"
],
"additionalProperties": false,
"description": "Network-wide totals."
},
"pagination": {
"type": [
"object",
"null"
],
"properties": {
"page": {
"type": "integer",
"description": "Zero-based page number of this response."
},
"size": {
"type": "integer",
"description": "Page size used for this response."
},
"total_items": {
"type": "integer",
"description": "Total number of matching entries across all pages."
},
"total_pages": {
"type": "integer",
"description": "Total number of pages."
}
},
"required": [
"page",
"size",
"total_items",
"total_pages"
],
"additionalProperties": false,
"description": "Pagination of this response."
}
},
"required": [
"retailers",
"meta",
"pagination"
],
"description": "A page of retailers plus network-wide totals and pagination.",
"additionalProperties": false
}🟢get_retailer(id_or_alias)
Get the public profile of one retailer (shop) on authorized.by. Read-only. Returns address, contact details, opening hours, categories, subscription plan, TÜV certification, customer rating, registration date, seal_implemented (whether the authorized.by seal is live on their shop), and certificate_url / certificate_url_de: links to the retailer's public authorized.by certificate page (English / German) listing all brands that authorized it. These links are null when the retailer has no active authorization. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.
入力スキーマ
{
"type": "object",
"properties": {
"id_or_alias": {
"description": "Retailer numeric ID, slug or alias.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"shop_url": {
"type": [
"string",
"null"
],
"description": "Retailer online-shop URL, or null."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"certificate_url": {
"type": [
"string",
"null"
],
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."
},
"certificate_url_de": {
"type": [
"string",
"null"
],
"description": "Same certificate page in German; null when there is no active authorization."
},
"plan": {
"type": [
"string",
"null"
],
"description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE."
},
"tuv_certified": {
"type": "boolean",
"description": "Whether the retailer holds a TÜV certification via authorized.by."
},
"seal_implemented": {
"type": "boolean",
"description": "Whether the authorized.by seal is live on the retailer's shop."
},
"brand_count": {
"type": "integer",
"description": "Number of brands that currently authorize this retailer on authorized.by."
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"opening_hours": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"day_of_week": {
"type": [
"string",
"null"
],
"description": "Day of the week."
},
"opening_hour": {
"type": [
"string",
"null"
],
"description": "Opening time."
},
"closing_hour": {
"type": [
"string",
"null"
],
"description": "Closing time."
}
},
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"additionalProperties": false
},
"description": "Weekly opening hours of the physical store; empty or null when unknown."
},
"payment_methods": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Accepted payment methods; null when unknown."
},
"description": {
"type": [
"object",
"null"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"required": [
"de",
"en"
],
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null."
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"required": [
"de",
"en"
],
"additionalProperties": false
},
"description": "Product categories."
},
"tuv_certification_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified."
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
},
"trustami": {
"type": [
"object",
"null"
],
"properties": {
"rating": {
"type": [
"number",
"null"
],
"description": "Average customer rating, or null."
},
"review_count": {
"type": [
"integer",
"null"
],
"description": "Number of customer reviews, or null."
},
"profile_url": {
"type": [
"string",
"null"
],
"description": "URL of the rating profile, or null."
}
},
"required": [
"rating",
"review_count",
"profile_url"
],
"additionalProperties": false,
"description": "Customer rating from Trustami; fields are null when no rating exists."
},
"social": {
"type": [
"object",
"null"
],
"properties": {
"instagram": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"additionalProperties": false,
"description": "Social media profile URLs; each may be null."
}
},
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"additionalProperties": false,
"description": "Extended profile details."
}
},
"required": [
"id",
"name",
"slug",
"shop_url",
"logo",
"certificate_url",
"certificate_url_de",
"plan",
"tuv_certified",
"seal_implemented",
"brand_count",
"details"
],
"description": "The public profile of one retailer.",
"additionalProperties": false
}🟢get_retailer_brands(id_or_alias)
List all brands a retailer (shop) is currently authorized to sell, according to authorized.by. Read-only. Use this to answer 'which brands has shop X been authorized for?'. Sorted by brand name. Each entry includes official_shop, partnership_date, and certificate_url / certificate_url_de: links to the public authorized.by certificate page (English / German) proving this specific brand-retailer authorization. Share the certificate link when a user needs verifiable proof. Only active partnerships are returned: confirmed by both the brand and the retailer, with both profiles public and the brand approved by authorized.by. Revoked or pending partnerships are never listed. Responses are cached and refreshed when the underlying profile or partnership changes, so a revocation may take a short time to disappear. partnership_date is the date the authorization STARTED, not the date it was last verified; a partnership listed here is currently active as of the response time. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.
入力スキーマ
{
"type": "object",
"properties": {
"id_or_alias": {
"description": "Retailer numeric ID, slug or alias.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"retailer_id": {
"type": "integer",
"description": "Numeric ID of the retailer the list belongs to."
},
"total": {
"type": "integer",
"description": "Number of entries in the list."
},
"brands": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"website_url": {
"type": [
"string",
"null"
],
"description": "Brand website URL, or null."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"official_shop": {
"type": "boolean",
"description": "Whether this shop is the brand's own official shop."
},
"certificate_url": {
"type": [
"string",
"null"
],
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."
},
"certificate_url_de": {
"type": [
"string",
"null"
],
"description": "Same certificate page in German; null when there is no active authorization."
},
"partnership_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response."
}
},
"required": [
"id",
"name",
"slug",
"website_url",
"logo",
"official_shop",
"certificate_url",
"certificate_url_de",
"partnership_date"
],
"additionalProperties": false
}
}
},
"required": [
"retailer_id",
"total",
"brands"
],
"description": "All brands that currently authorize the retailer, with per-brand certificate links.",
"additionalProperties": false
}推奨プロンプト
get_brandsget_brandsコミュニティ
エビデンス