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개