Sami Swoi
Directory of Polish-run businesses outside Poland: shops, tradespeople, doctors, services.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~2,127トークン数（ツール定義）
~5.0 KB一般的なレスポンスサイズ
注意への影響は中程度（128k コンテキストの 1.66%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"firmy": {
"url": "https://samiswoi.app/mcp"
}
}
}リモートエンドポイント
https://samiswoi.app/mcpstreamable-httpできること
ツール一覧
ツール（4）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢search_companies(country, city, category, query, limit, ...)
Search Polish-run businesses outside Poland listed on Sami Swoi (samiswoi.app), for questions like "Polish plumber in London", "Polish shop in Utrecht", "Polish dentist in Oslo", "polska księgowa w Dublinie". Filters: country, city, category (slug or Polish word, see list_categories) and a phrase from the name or kind of business. Returns up to 20 businesses per call (page with offset/next_offset), each with city, category and its samiswoi.app page, plus the total. / Polskie firmy za granicą: kraj, miasto, kategoria, fraza.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Country: ISO code (\"GB\", \"DE\", \"NL\") or name in Polish or English (\"Holandia\", \"Germany\"). / Kraj."
},
"city": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "City, e.g. \"London\", \"Londyn\", \"Utrecht\". Best together with country. / Miasto."
},
"category": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Category slug from list_categories (e.g. \"hydraulik\", \"sklep-spozywczy\") or a Polish word (\"dentysta\", \"fryzjer\"). / Kategoria."
},
"query": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Words from the business name or kind, Polish works best (\"delikatesy\", \"mechanik\", \"Biedronka\"). / Fraza."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10,
"description": "Maximum results (1-20, default 10)."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 2000,
"default": 0,
"description": "Skip this many matches; use next_offset."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"no_companies",
"country_not_found",
"category_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"query": {
"type": "object",
"description": "Filters as applied.",
"additionalProperties": true
},
"total_found": {
"type": "integer"
},
"returned": {
"type": "integer"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Company id (address on samiswoi.app); use with get_company."
},
"name": {
"type": "string"
},
"category": {
"type": "string",
"description": "Category slug (see list_categories)."
},
"category_label": {
"type": "string",
"description": "Category name in Polish."
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2."
},
"country": {
"type": "string",
"description": "Country name in Polish."
},
"city": {
"type": "string"
},
"managed_by_owner": {
"type": "boolean",
"description": "true = the owner runs this profile; false = built from public data, not yet claimed."
},
"url": {
"type": "string",
"description": "Company page on samiswoi.app (contact details, map)."
}
},
"required": [
"id",
"name",
"category",
"category_label",
"country_code",
"country",
"city",
"managed_by_owner",
"url"
],
"additionalProperties": false
}
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"value",
"name"
],
"additionalProperties": false
}
},
"next_offset": {
"type": "integer"
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢get_company(id, url)
One Polish business abroad on Sami Swoi by its id or samiswoi.app page URL: category, city and country, address, website, languages, opening hours, short description and the data source. Phone and e-mail are on the linked page. / Profil jednej firmy.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 3,
"maxLength": 40,
"description": "Company id from search_companies, e.g. \"polski-sklep-utrecht\"."
},
"url": {
"type": "string",
"minLength": 10,
"maxLength": 200,
"description": "Company page URL, e.g. https://samiswoi.app/polski-sklep-utrecht"
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Company id (address on samiswoi.app); use with get_company."
},
"name": {
"type": "string"
},
"category": {
"type": "string",
"description": "Category slug (see list_categories)."
},
"category_label": {
"type": "string",
"description": "Category name in Polish."
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2."
},
"country": {
"type": "string",
"description": "Country name in Polish."
},
"city": {
"type": "string"
},
"managed_by_owner": {
"type": "boolean",
"description": "true = the owner runs this profile; false = built from public data, not yet claimed."
},
"url": {
"type": "string",
"description": "Company page on samiswoi.app (contact details, map)."
},
"description": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"object",
"null"
],
"properties": {
"street": {
"type": [
"string",
"null"
]
},
"postcode": {
"type": [
"string",
"null"
]
},
"city": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"street",
"postcode",
"city",
"country"
],
"additionalProperties": false
},
"website": {
"type": [
"string",
"null"
]
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Languages spoken (always includes Polish)."
},
"opening_hours": {
"type": "array",
"items": {
"type": "string"
},
"description": "e.g. \"Mon 09:00-17:00\"; empty when unknown."
},
"source": {
"type": "string",
"description": "Where the data comes from."
},
"country_url": {
"type": "string"
},
"category_url": {
"type": "string"
},
"city_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"category",
"category_label",
"country_code",
"country",
"city",
"managed_by_owner",
"url",
"description",
"address",
"website",
"languages",
"opening_hours",
"source",
"country_url",
"category_url",
"city_url"
],
"additionalProperties": false
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢list_countries
Countries with Polish businesses listed on Sami Swoi: ISO code, Polish name, number of businesses and the country page. / Kraje i liczba polskich firm.
入力スキーマ
{
"type": "object",
"properties": {},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"total_companies": {
"type": "integer"
},
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"companies": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"code",
"name",
"companies",
"url"
],
"additionalProperties": false
}
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}🟢list_categories(country)
Business categories used by Sami Swoi (slug, Polish name, group, number of listed businesses) for the category filter of search_companies. Optional country limits the counts to one country. / Kategorie firm.
入力スキーマ
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Country: ISO code (\"GB\", \"DE\", \"NL\") or name in Polish or English (\"Holandia\", \"Germany\"). / Kraj."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"found",
"country_not_found",
"invalid_request",
"temporary_error"
]
},
"message": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"group": {
"type": "string"
},
"companies": {
"type": "integer"
}
},
"required": [
"slug",
"name",
"group",
"companies"
],
"additionalProperties": false
}
},
"browse_url": {
"type": "string",
"description": "Page on samiswoi.app with the full list."
},
"note": {
"type": "string",
"description": "Guidance for answering, e.g. when nothing was found."
}
},
"required": [
"ok",
"status"
],
"additionalProperties": false
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 4 件