Sondaże.pro — Polish Polls
MCP server for Polish political polls, averages, seat projections, and regional estimates.
사용해야 할까요
품질 및 안전성
발견 사항 (9)
- LOWget_polling_averages에서
- LOWget_polling_averages_series에서
- LOWget_seat_projections에서
- LOWget_surveys에서
- LOWget_national_projection에서
- LOWget_district_projections에서
- LOWget_voivodeship_projections에서
- LOWget_county_projections에서
- LOWget_pollsters에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"polls-mcp": {
"url": "https://api.sondaze.pro/mcp/"
}
}
}원격 엔드포인트
https://api.sondaze.pro/mcp/streamable-http할 수 있는 일
도구 목록
도구 (13)
🟢get_polling_averages(period_type, period_key, strategy, survey_id, strategy_version)
Pobiera znormalizowane lub surowe (RAW) średnie sondażowe poparcia partii politycznych w Polsce dla wskazanego okresu (miesiąc, tydzień ISO lub okno kroczące rolling 14/21/30 dni).
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Typ okresu: month (np. 2025-10), week (np. 2025-W42) lub rolling (np. last-30d, last-14d, 2025-11-10:P21D)"
},
"period_key": {
"type": "string",
"description": "Klucz okresu: YYYY-MM dla month, YYYY-Www dla week, last-14d|last-21d|last-30d lub YYYY-MM-DD:P{N}D dla rolling"
},
"strategy": {
"type": "string",
"enum": [
"weighted_average",
"arithmetic_average",
"weighted_average_raw",
"arithmetic_average_raw"
],
"description": "Strategia wyliczania średniej (domyślnie weighted_average - ważona wielkością próby z re-normalizacją do 100%)"
},
"survey_id": {
"type": "string",
"description": "Opcjonalna lista ID sondaży w formacie JSON string, np. \"[101,102]\". Jeśli brak, uwzględniane są wszystkie sondaże w okresie."
},
"strategy_version": {
"type": "integer",
"description": "Wersja strategii (domyślnie 1)"
}
},
"required": [
"period_type",
"period_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_polling_averages_series(range, year, strategy, pollster_id, include_empty_months, ...)
Pobiera szereg czasowy miesięcznych średnich poparcia partii politycznych w Polsce (ostatnie 12 miesięcy lub wybrany rok) do analizy trendów historycznych.
입력 스키마
{
"type": "object",
"properties": {
"range": {
"type": "string",
"enum": [
"last_12",
"year"
],
"description": "Zakres serii: last_12 (ostatnie 12 miesięcy) lub year (konkretny rok kalendarzowy)"
},
"year": {
"type": "integer",
"description": "Rok (np. 2025), wymagany gdy range=year"
},
"strategy": {
"type": "string",
"enum": [
"weighted_average",
"arithmetic_average",
"weighted_average_raw",
"arithmetic_average_raw"
],
"description": "Strategia wyliczania średnich"
},
"pollster_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "array",
"items": {
"type": "integer"
}
},
{
"type": "string"
}
],
"description": "Opcjonalny filtr po ID pracowni badawczej"
},
"include_empty_months": {
"type": "boolean",
"description": "Czy zwracać miesiące bez sondaży jako status \"no_surveys\""
},
"strategy_version": {
"type": "integer",
"description": "Wersja strategii (domyślnie 1)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_seat_projections(period_type, period_key, strategy, survey_id, strategy_version)
Symuluje podział 460 mandatów w Sejmie RP metodą d'Hondta na podstawie średnich sondażowych z wybranego okresu przy użyciu wieloszczeblowego modelu oddolnego (Bottom-Up: 380 powiatów -> 41 okręgów -> kraj). Dopuszcza wyłącznie strategie znormalizowane.
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Typ okresu: month (np. 2025-10), week (np. 2025-W42) lub rolling (np. last-30d)"
},
"period_key": {
"type": "string",
"description": "Klucz okresu: YYYY-MM dla month, YYYY-Www dla week, last-14d|last-21d|last-30d lub YYYY-MM-DD:P{N}D dla rolling"
},
"strategy": {
"type": "string",
"enum": [
"weighted_average",
"arithmetic_average"
],
"description": "Strategia średnich (domyślnie weighted_average). Strategie surowe *_raw są niedozwolone w kalkulacji mandatów."
},
"survey_id": {
"type": "string",
"description": "Opcjonalna lista ID sondaży w formacie JSON string, np. \"[101,102]\""
},
"strategy_version": {
"type": "integer",
"description": "Wersja strategii (domyślnie 1)"
}
},
"required": [
"period_type",
"period_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_surveys(period_type, period_key, pollster_id, date_from, date_to, ...)
Pobiera kolekcję pojedynczych sondaży poparcia partii politycznych wraz ze szczegółowymi wynikami, metadanymi pracowni, próbą badawczą N, datami realizacji i strukturą partii.
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Filtruj po typie okresu agregacji"
},
"period_key": {
"type": "string",
"description": "Filtruj po kluczu okresu (np. 2025-10, 2025-W42, last-30d)"
},
"pollster_id": {
"type": "integer",
"description": "Filtruj po ID pracowni badawczej"
},
"date_from": {
"type": "string",
"description": "Początek zakresu dat publikacji lub badania (YYYY-MM-DD)"
},
"date_to": {
"type": "string",
"description": "Koniec zakresu dat publikacji lub badania (YYYY-MM-DD)"
},
"page": {
"type": "integer",
"minimum": 1,
"description": "Numer strony (domyślnie 1)"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"description": "Liczba wyników na stronę (domyślnie 50, max 500)"
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Opcjonalny offset wyników"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_surveys_ids(period_type, period_key)
Zwraca listę numerycznych identyfikatorów sondaży należących do zadanego okresu agregacji.
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Typ okresu: month, week lub rolling"
},
"period_key": {
"type": "string",
"description": "Klucz okresu: YYYY-MM, YYYY-Www, last-14d|last-21d|last-30d lub YYYY-MM-DD:P{N}D"
}
},
"required": [
"period_type",
"period_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_national_projection(period_type, period_key, strategy, turnout)
Zwraca ogólnopolską projekcję poparcia partii i szacowaną liczbę ważnych głosów wyliczoną wieloszczeblowym modelem oddolnym (Multilevel Bottom-Up Model) dla pełnego okresu.
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Typ okresu: month, week lub rolling"
},
"period_key": {
"type": "string",
"description": "Klucz okresu: YYYY-MM, YYYY-Www, last-14d|last-21d|last-30d lub YYYY-MM-DD:P{N}D"
},
"strategy": {
"type": "string",
"enum": [
"weighted_average",
"arithmetic_average"
],
"description": "Strategia średnich wejściowych (domyślnie weighted_average)"
},
"turnout": {
"type": "number",
"description": "Opcjonalna symulowana frekwencja ogólnokrajowa (%)"
}
},
"required": [
"period_type",
"period_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_district_projections(period_type, period_key, strategy, turnout)
Zwraca szczegółowe projekcje poparcia partii, szacowaną frekwencję i rozkład głosów we wszystkich 41 okręgach wyborczych do Sejmu RP.
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Typ okresu: month, week lub rolling"
},
"period_key": {
"type": "string",
"description": "Klucz okresu (np. 2025-10, 2025-W42, last-30d)"
},
"strategy": {
"type": "string",
"enum": [
"weighted_average",
"arithmetic_average"
],
"description": "Strategia średnich wejściowych"
},
"turnout": {
"type": "number",
"description": "Opcjonalna symulowana frekwencja ogólnokrajowa (%)"
}
},
"required": [
"period_type",
"period_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_voivodeship_projections(period_type, period_key, strategy, turnout)
Zwraca projekcje poparcia partii politycznych w podziale na 16 województw dla pełnego okresu agregacji.
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Typ okresu: month, week lub rolling"
},
"period_key": {
"type": "string",
"description": "Klucz okresu (np. 2025-10, 2025-W42, last-30d)"
},
"strategy": {
"type": "string",
"enum": [
"weighted_average",
"arithmetic_average"
],
"description": "Strategia średnich wejściowych"
},
"turnout": {
"type": "number",
"description": "Opcjonalna symulowana frekwencja ogólnokrajowa (%)"
}
},
"required": [
"period_type",
"period_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_county_projections(period_type, period_key, strategy, turnout, voivodeship_code, ...)
Zwraca lokalne projekcje poparcia partii na poziomie 380 powiatów z możliwością filtrowania po kodzie województwa lub numerze okręgu wyborczego.
입력 스키마
{
"type": "object",
"properties": {
"period_type": {
"type": "string",
"enum": [
"month",
"week",
"rolling"
],
"description": "Typ okresu: month, week lub rolling"
},
"period_key": {
"type": "string",
"description": "Klucz okresu (np. 2025-10, 2025-W42, last-30d)"
},
"strategy": {
"type": "string",
"enum": [
"weighted_average",
"arithmetic_average"
],
"description": "Strategia średnich wejściowych"
},
"turnout": {
"type": "number",
"description": "Opcjonalna symulowana frekwencja ogólnokrajowa (%)"
},
"voivodeship_code": {
"type": "string",
"description": "Kod TERYT województwa (np. \"14\" dla mazowieckiego, \"02\" dla dolnośląskiego)"
},
"district_number": {
"type": "integer",
"minimum": 1,
"maximum": 41,
"description": "Numer okręgu wyborczego do Sejmu (1-41)"
}
},
"required": [
"period_type",
"period_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_parties
Zwraca słownik partii politycznych w Polsce wraz z progami wyborczymi (5% partia, 8% koalicja), informacją o statusie koalicji, kolorami i slugami.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_pollsters
Zwraca słownik ośrodków i pracowni badawczych realizujących sondaże polityczne w Polsce (CBOS, IBRiS, United Surveys, Opinia24, IPSOS, Social Changes itp.).
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_aggregation_periods
Zwraca listę dostępnych w systemie okresów agregacji sondaży (miesięczne, tygodniowe i okna kroczące rolling).
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_political_events(date_from, date_to, limit)
Zwraca listę kluczowych wydarzeń politycznych (tzw. bombshells) wpływających na dynamikę poparcia społecznego z opcjonalnym filtrowaniem po zakresie dat.
입력 스키마
{
"type": "object",
"properties": {
"date_from": {
"type": "string",
"description": "Początek zakresu dat (YYYY-MM-DD)"
},
"date_to": {
"type": "string",
"description": "Koniec zakresu dat (YYYY-MM-DD)"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"description": "Maksymalna liczba zdarzeń do pobrania"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거