brands
Search brands and find authorized retailers on authorized.by
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `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社区
证据