Open Economics
Discover, resolve, and query official Brazilian economic data with semantic search and provenance.
我該用這個嗎
品質與安全性
A
發現項目（3）
- LOWTool 'get_epe_electricity_consumption' name length outside 3-30 range在 get_epe_electricity_consumption 中
- LOWTool 'get_mte_formal_employment_schema' name length outside 3-30 range在 get_mte_formal_employment_schema 中
- LOWTool 'get_cvm_investment_funds_schema' name length outside 3-30 range在 get_cvm_investment_funds_schema 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~9,680Token（工具定義）
~5.4 KB典型回應大小
顯著的注意力影響（128k 上下文的 7.56%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"open-economics": {
"url": "https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp"
}
}
}遠端端點
https://open-economics-data.knbf982hkn.chatgpt.site/api/mcpstreamable-http它能做什麼
工具清單
工具（19）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢search_official_data(query, limit)
Start here for a natural-language Brazilian economic-information need in Portuguese or English. Resolves the economic concept independently of current coverage, returns ranked official datasets, stable-series shortcuts, confidence, missing source integrations, and an explicit unresolved/partial state. Use this before any data query when the exact official dataset ID is unknown.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"description": "The user's complete economic-data need, including measure, geography, period, and breakdown when known.",
"type": "string",
"minLength": 2,
"maxLength": 300
},
"limit": {
"description": "Maximum official dataset candidates to return.",
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"query": {
"description": "The original natural-language economic need.",
"type": "string"
},
"normalizedQuery": {
"description": "Normalized form used for semantic resolution.",
"type": "string"
},
"resolution": {
"description": "Concept-resolution result.",
"type": "object",
"properties": {
"status": {
"description": "Resolution state for the requested concept.",
"type": "string"
},
"confidence": {
"description": "Resolution confidence from 0 to 1.",
"type": "number"
},
"explanation": {
"description": "Why the concept was or was not resolved.",
"type": "string"
}
},
"required": [
"status",
"explanation"
],
"additionalProperties": {}
},
"concepts": {
"description": "Ranked economic concepts matched to the request.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Stable Open Economics concept ID.",
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": {}
}
},
"datasets": {
"description": "Ranked official datasets and their source identity.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Stable official dataset ID.",
"type": "string"
},
"provider": {
"description": "Open Economics provider identifier.",
"type": "string"
},
"sourceAgency": {
"description": "Official publishing agency.",
"type": "string"
},
"title": {
"description": "Official dataset title.",
"type": "string"
},
"sourceUrl": {
"description": "Official source URL.",
"type": "string"
},
"metadataUrl": {
"description": "Official metadata URL.",
"type": "string"
}
},
"required": [
"id",
"provider",
"sourceAgency",
"title",
"sourceUrl",
"metadataUrl"
],
"additionalProperties": {}
}
},
"availability": {
"description": "Coverage assessment.",
"type": "object",
"properties": {
"status": {
"description": "Availability state in the current Open Economics coverage.",
"type": "string"
},
"complete": {
"description": "Whether the requested need is completely covered.",
"type": "boolean"
},
"explanation": {
"description": "Coverage explanation.",
"type": "string"
},
"missingSources": {
"description": "Required source integrations that are not present.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"complete",
"explanation",
"missingSources"
],
"additionalProperties": {}
}
},
"required": [
"query",
"normalizedQuery",
"resolution",
"concepts",
"datasets",
"availability"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "Semantic discovery result with ranked concepts, official datasets, and coverage state.",
"additionalProperties": {}
}🟢describe_official_dataset(dataset_id)
Get identity, publisher, collection, provenance links, query capability, and any stable Open Economics series shortcuts for an exact dataset ID returned by search_official_data. This does not fetch observations.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "Exact ID returned by search_official_data, such as bcb-sgs:432, ibge-aggregates:5932, siconfi:dca, tesouro-rtn:government-central, tesouro-dpf:debt-profile, comexstat:general, anp:fuel-prices, epe:electricity-consumption, mte:formal-employment, or cvm:investment-funds.",
"type": "string",
"pattern": "^(?:(?:bcb-sgs|ibge-aggregates):\\d+|siconfi:(?:rreo|rgf|dca|entes)|tesouro-rtn:government-central|tesouro-dpf:debt-profile|comexstat:general|anp:fuel-prices|epe:electricity-consumption|mte:formal-employment|cvm:investment-funds)$"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"description": "Stable official dataset ID.",
"type": "string"
},
"provider": {
"description": "Open Economics provider identifier.",
"type": "string"
},
"sourceAgency": {
"description": "Official publishing agency.",
"type": "string"
},
"title": {
"description": "Official dataset title.",
"type": "string"
},
"collection": {
"description": "Official collection identifier, when supplied by the publisher.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"collectionName": {
"description": "Official collection name, when supplied by the publisher.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"description": "Official source URL.",
"type": "string"
},
"metadataUrl": {
"description": "Official metadata URL.",
"type": "string"
},
"queryCapability": {
"description": "Supported query capability.",
"type": "string"
}
},
"required": [
"id",
"provider",
"sourceAgency",
"title",
"sourceUrl",
"metadataUrl",
"queryCapability"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "Official dataset identity, source, provenance, and query capability.",
"additionalProperties": {}
}🟢get_bcb_series(dataset_id, start, end, order, limit)
Retrieve official observations and authoritative schema metadata for an exact BCB SGS dataset ID. Use only after search_official_data identifies the series. Dates, units, periodicity, source, and raw values are preserved; generic access does not guess transformations.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "Exact BCB dataset ID returned by search_official_data.",
"type": "string",
"pattern": "^bcb-sgs:\\d+$"
},
"start": {
"description": "Inclusive start date; defaults to three years ago.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end": {
"description": "Inclusive end date; defaults to today.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"order": {
"description": "Observation order by date.",
"default": "asc",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"description": "Maximum number of observations to return.",
"default": 5000,
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_bcb_schema(dataset_id)
Fetch authoritative metadata for an exact BCB SGS series, including full name, subject hierarchy, periodicity, unit, source, coverage dates, decimals, formula, and warnings. Use when interpreting a BCB series without retrieving observations.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "Exact BCB dataset ID returned by search_official_data.",
"type": "string",
"pattern": "^bcb-sgs:\\d+$"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_ibge_schema(dataset_id)
Fetch official metadata for an IBGE aggregate selected by search_official_data. Always use this before get_ibge_data unless the official variable, locality, and classification IDs are already known. It prevents guessing a measure or dimensional slice.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "Exact IBGE aggregate ID returned by search_official_data.",
"type": "string",
"pattern": "^ibge-aggregates:\\d+$"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_ibge_data(dataset_id, variable, periods, locality, classification)
Retrieve an explicit slice of an IBGE aggregate after inspecting its schema. Returns variables containing classification selections, geographies, and observations; official suppression, missing, quality-flag, and zero states remain distinct.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "Exact IBGE aggregate ID returned by search_official_data.",
"type": "string",
"pattern": "^ibge-aggregates:\\d+$"
},
"variable": {
"description": "One or more official variable IDs separated by |.",
"type": "string",
"pattern": "^\\d+(?:\\|\\d+)*$"
},
"periods": {
"description": "Recent-period shorthand such as -12, or explicit official period IDs separated by |.",
"default": "-12",
"type": "string",
"pattern": "^(?:-\\d{1,3}|\\d{4,6}(?:\\|\\d{4,6}){0,119})$"
},
"locality": {
"description": "BR or an explicit IBGE geography selection such as N3[35].",
"default": "BR",
"type": "string",
"pattern": "^(?:BR|N\\d{1,2}\\[(?:all|\\d+(?:,\\d+)*)\\])$"
},
"classification": {
"description": "Explicit classification selections from the schema, such as 11255[90707].",
"type": "string",
"pattern": "^\\d+\\[(?:all|\\d+(?:,\\d+)*)\\](?:\\|\\d+\\[(?:all|\\d+(?:,\\d+)*)\\])*$"
}
},
"required": [
"dataset_id",
"variable"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_siconfi_schema(dataset_id)
Get the meaning and required selection fields for an exact SICONFI dataset returned by search_official_data. Use this before get_siconfi_data so entity, reporting period, report type, government branch, and annex are explicit rather than guessed.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "Exact SICONFI dataset ID returned by search_official_data.",
"type": "string",
"pattern": "^siconfi:(?:rreo|rgf|dca|entes)$"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_siconfi_data(dataset_id, year, entity, period, periodicity, ...)
Retrieve an explicit official SICONFI DCA, RREO, RGF, or entity-registry selection. First inspect the schema. This tool preserves account, column, annex, period, entity, raw value fields, and upstream provenance without aggregating or substituting concepts.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "Exact SICONFI dataset ID returned by search_official_data.",
"type": "string",
"pattern": "^siconfi:(?:rreo|rgf|dca|entes)$"
},
"year": {
"description": "Calendar year of the official report.",
"type": "integer",
"minimum": 2013,
"maximum": 2100
},
"entity": {
"description": "Official IBGE entity code.",
"type": "integer",
"minimum": 1,
"maximum": 9999999
},
"period": {
"description": "RREO bimestre (1-6) or RGF period (1-3).",
"type": "integer",
"minimum": 1,
"maximum": 6
},
"periodicity": {
"description": "RGF only: four-month (Q) or half-year (S).",
"type": "string",
"enum": [
"Q",
"S"
]
},
"report_type": {
"description": "Official SICONFI report type for the selected dataset.",
"type": "string",
"enum": [
"RREO",
"RREO Simplificado",
"RGF",
"RGF Simplificado"
]
},
"power": {
"description": "RGF government branch.",
"type": "string",
"enum": [
"E",
"L",
"J",
"M",
"D"
]
},
"sphere": {
"description": "Government sphere: municipal, state, federal, or consortium.",
"type": "string",
"enum": [
"M",
"E",
"U",
"C"
]
},
"annex": {
"description": "Exact official annex name from the SICONFI documentation.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_comexstat_data(dataset_id, flow, from, to, month_detail, ...)
Retrieve a bounded, explicit MDIC Comex Stat export or import slice from 1997 onward. Use comexstat:general only after search_official_data. Select period, dimensions, metrics, and optional official filter codes; partner, product, state, transport, classification, and raw metric fields remain attached to the result.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official MDIC Comex Stat dataset identifier.",
"type": "string",
"const": "comexstat:general"
},
"flow": {
"description": "Trade direction to retrieve.",
"type": "string",
"enum": [
"export",
"import"
]
},
"from": {
"description": "First month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"to": {
"description": "Last month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"month_detail": {
"description": "Whether to keep month-level detail in the response.",
"default": true,
"type": "boolean"
},
"details": {
"description": "Official dimensions to include, up to eight.",
"default": [],
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"enum": [
"country",
"economicBlock",
"state",
"via",
"urf",
"ncm",
"subHeading",
"heading",
"chapter",
"section",
"BECLevel3",
"BECLevel2",
"BECLevel1",
"SITCBasicHeading",
"SITCSubGroup",
"SITCGroup",
"SITCDivision",
"SITCSection",
"ISICClass",
"ISICGroup",
"ISICDivision",
"ISICSection"
]
}
},
"metrics": {
"description": "Official Comex Stat metrics to return.",
"default": [
"metricFOB"
],
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"metricFOB",
"metricKG",
"metricStatistic",
"metricFreight",
"metricInsurance",
"metricCIF"
]
}
},
"filters": {
"description": "Optional official dimension filters.",
"default": [],
"maxItems": 6,
"type": "array",
"items": {
"type": "object",
"properties": {
"filter": {
"description": "Official dimension code to filter.",
"type": "string",
"enum": [
"country",
"economicBlock",
"state",
"via",
"urf",
"ncm",
"subHeading",
"heading",
"chapter",
"section",
"BECLevel3",
"BECLevel2",
"BECLevel1",
"SITCBasicHeading",
"SITCSubGroup",
"SITCGroup",
"SITCDivision",
"SITCSection",
"ISICClass",
"ISICGroup",
"ISICDivision",
"ISICSection"
]
},
"values": {
"description": "One or more official filter values.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 30
},
{
"type": "number"
}
]
}
}
},
"required": [
"filter",
"values"
]
}
},
"language": {
"description": "Language for labels in the upstream response.",
"default": "pt",
"type": "string",
"enum": [
"pt",
"en",
"es"
]
}
},
"required": [
"dataset_id",
"flow",
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_anp_fuel_prices(dataset_id, fuel_group, year, month, geography, ...)
Retrieve auditable fuel and GLP price statistics calculated from official ANP station observations. Omit year and month for the rolling latest four weeks, or provide both for a published monthly file from 2023 onward. Results retain period, product, geography, unit, sample count, source URL, and the disclosed aggregation method while excluding station identity and addresses.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official ANP fuel-prices dataset identifier.",
"type": "string",
"const": "anp:fuel-prices"
},
"fuel_group": {
"description": "ANP product group to retrieve.",
"type": "string",
"enum": [
"gasoline-ethanol",
"diesel-gnv",
"glp"
]
},
"year": {
"description": "Published source year; provide with month for a monthly file.",
"type": "integer",
"minimum": 2023,
"maximum": 2100
},
"month": {
"description": "Published source month; provide with year for a monthly file.",
"type": "integer",
"minimum": 1,
"maximum": 12
},
"geography": {
"description": "Geographic aggregation level.",
"default": "country",
"type": "string",
"enum": [
"country",
"region",
"state",
"municipality"
]
},
"period": {
"description": "Reporting period granularity.",
"default": "week",
"type": "string",
"enum": [
"week",
"month"
]
},
"state": {
"description": "Two-letter Brazilian state code when geography is state or municipality.",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"municipality": {
"description": "Municipality name when geography is municipality.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"product": {
"description": "Exact ANP product label, for example GASOLINA or ETANOL.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"limit": {
"description": "Maximum aggregate rows to return.",
"default": 1000,
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
"required": [
"dataset_id",
"fuel_group"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_epe_electricity_consumption(dataset_id, from, to, geography, states, ...)
Retrieve monthly EPE electricity consumption and consumer counts from 2004 onward. Select a bounded period, country/region/UF geography, consumption classes, and regulated/free market. The response identifies the exact synchronized official workbook version and discloses aggregation across source system rows.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official EPE electricity-consumption dataset identifier.",
"type": "string",
"const": "epe:electricity-consumption"
},
"from": {
"description": "Inclusive first month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"to": {
"description": "Inclusive last month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"geography": {
"description": "Geographic aggregation level.",
"default": "country",
"type": "string",
"enum": [
"country",
"region",
"state"
]
},
"states": {
"description": "Optional official state codes when geography is state.",
"default": [],
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"enum": [
"AC",
"AL",
"AM",
"AP",
"BA",
"CE",
"DF",
"ES",
"GO",
"MA",
"MG",
"MS",
"MT",
"PA",
"PB",
"PE",
"PI",
"PR",
"RJ",
"RN",
"RO",
"RR",
"RS",
"SC",
"SE",
"SP",
"TO"
]
}
},
"regions": {
"description": "Optional official regions when geography is region.",
"default": [],
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"Centro-Oeste",
"Nordeste",
"Norte",
"Sudeste",
"Sul"
]
}
},
"classes": {
"description": "Consumption classes to include.",
"default": [
"Comercial",
"Industrial",
"Outros",
"Residencial",
"Rural"
],
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"Comercial",
"Industrial",
"Outros",
"Residencial",
"Rural"
]
}
},
"markets": {
"description": "Electricity-market segments to include.",
"default": [
"Cativo",
"Livre"
],
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"Cativo",
"Livre"
]
}
},
"limit": {
"description": "Maximum rows to return.",
"default": 1000,
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_mte_formal_employment_schema(dataset_id)
Inspect the official adjusted Novo Caged selection contract, source vintage, measure meanings, available industry IDs, and the constraint that geography and industry come from separate official tables. Use before an industry query.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official MTE Novo Caged dataset identifier.",
"type": "string",
"const": "mte:formal-employment"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_mte_formal_employment(dataset_id, from, to, breakdown, states, ...)
Retrieve revised monthly Novo Caged stock, admissions, dismissals, balance, and relative change from 2020 onward. Select exactly one official breakdown: country, region, state, or economic activity. The response preserves the MTE workbook vintage and never synthesizes state-by-industry values.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official MTE Novo Caged dataset identifier.",
"type": "string",
"const": "mte:formal-employment"
},
"from": {
"description": "Inclusive first month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"to": {
"description": "Inclusive last month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"breakdown": {
"description": "Official breakdown for the employment result.",
"default": "country",
"type": "string",
"enum": [
"country",
"region",
"state",
"industry"
]
},
"states": {
"description": "Optional official state codes when breakdown is state.",
"default": [],
"maxItems": 27,
"type": "array",
"items": {
"type": "string",
"enum": [
"AC",
"AL",
"AM",
"AP",
"BA",
"CE",
"DF",
"ES",
"GO",
"MA",
"MG",
"MS",
"MT",
"PA",
"PB",
"PE",
"PI",
"PR",
"RJ",
"RN",
"RO",
"RR",
"RS",
"SC",
"SE",
"SP",
"TO"
]
}
},
"regions": {
"description": "Optional official regions when breakdown is region.",
"default": [],
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"Centro-Oeste",
"Nordeste",
"Norte",
"Sudeste",
"Sul"
]
}
},
"industries": {
"description": "Exact official activity IDs returned by get_mte_formal_employment_schema; empty means all activities.",
"default": [],
"maxItems": 26,
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
}
},
"limit": {
"description": "Maximum rows to return.",
"default": 1000,
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_cvm_investment_funds_schema(dataset_id)
Inspect the synchronized CVM daily-report window, official classifications, fund-search contract, measure meanings, and aggregation constraints. Use before querying a fund by name or comparing classes.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official CVM investment-funds dataset identifier.",
"type": "string",
"const": "cvm:investment-funds"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_tesouro_rtn_schema(dataset_id)
Inspect RTN table 1.2 account IDs, hierarchy, current-value unit, coverage, source vintage, and above/below-the-line constraints. Use before selecting revenue or expenditure categories.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official Tesouro Nacional RTN dataset identifier.",
"type": "string",
"const": "tesouro-rtn:government-central"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_tesouro_rtn(dataset_id, from, to, accounts, query, ...)
Retrieve monthly current-value RTN accounts from 1997 onward. Defaults to total revenue, transfers, net revenue, total expenditure, and the above-the-line primary result; select exact account IDs or search account labels for detail.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official Tesouro Nacional RTN dataset identifier.",
"type": "string",
"const": "tesouro-rtn:government-central"
},
"from": {
"description": "Inclusive first month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"to": {
"description": "Inclusive last month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"accounts": {
"description": "Exact account IDs returned by get_tesouro_rtn_schema.",
"default": [],
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d+(?:\\.\\d+)*$"
}
},
"query": {
"description": "Account-label search; omit accounts to search the full tree.",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"limit": {
"description": "Maximum account rows to return.",
"default": 1000,
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_tesouro_dpf_schema(dataset_id)
Inspect the six versioned RMD annex tables, their distinct units and coverage, category IDs, holder definitions, source publication, and methodological constraints before selecting data.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official Tesouro Nacional DPF debt-profile dataset identifier.",
"type": "string",
"const": "tesouro-dpf:debt-profile"
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_tesouro_dpf(dataset_id, table, from, to, categories, ...)
Retrieve one official monthly RMD table at a time: debt composition, DPMFi holders, average maturity, average maturity by indexer, monthly cost, or twelve-month cost. Units remain table-specific and are never combined.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official Tesouro Nacional DPF debt-profile dataset identifier.",
"type": "string",
"const": "tesouro-dpf:debt-profile"
},
"table": {
"description": "Versioned RMD table to retrieve.",
"default": "composition",
"type": "string",
"enum": [
"composition",
"holders",
"average-maturity",
"average-maturity-by-indexer",
"monthly-cost",
"twelve-month-cost"
]
},
"from": {
"description": "Inclusive first month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"to": {
"description": "Inclusive last month, YYYY-MM.",
"type": "string",
"pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$"
},
"categories": {
"description": "Exact category IDs returned for the selected table by get_tesouro_dpf_schema.",
"default": [],
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
}
},
"query": {
"description": "Category-label search; useful when category IDs are unknown.",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"limit": {
"description": "Maximum debt-statistics rows to return.",
"default": 1000,
"type": "integer",
"minimum": 1,
"maximum": 5000
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}🟢get_cvm_investment_funds(dataset_id, from, to, breakdown, classifications, ...)
Retrieve daily CVM aggregates by official fund classification or resolve a fund/class latest report by CNPJ or name. Net assets and flows are additive; quota values stay fund-level; reported holder totals are not deduplicated people.
輸入結構描述
{
"type": "object",
"properties": {
"dataset_id": {
"description": "The official CVM investment-funds dataset identifier.",
"type": "string",
"const": "cvm:investment-funds"
},
"from": {
"description": "Inclusive first report date, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to": {
"description": "Inclusive last report date, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"breakdown": {
"description": "Whether to aggregate by official classification or resolve a fund.",
"default": "classification",
"type": "string",
"enum": [
"classification",
"fund"
]
},
"classifications": {
"description": "Official fund classifications to include.",
"default": [],
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"Ações",
"Cambial",
"FMP-FGTS",
"Multimercado",
"Não classificado",
"Renda Fixa"
]
}
},
"funds": {
"description": "Unformatted 14-digit fund/class CNPJ values.",
"default": [],
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{14}$"
}
},
"query": {
"description": "Fund-name search; use only with breakdown=fund.",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"limit": {
"description": "Maximum fund or classification rows to return.",
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"dataset_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"data": {
"description": "Source-preserving data or schema payload for the selected official dataset."
},
"meta": {
"description": "Response metadata and source provenance.",
"type": "object",
"properties": {
"dataset": {
"description": "Open Economics dataset identity when supplied."
},
"provenance": {
"description": "Upstream source URLs, versions, timestamps, and methodology details."
}
},
"additionalProperties": {}
},
"links": {
"description": "Related API links.",
"type": "object",
"properties": {
"self": {
"description": "Canonical URL for this response.",
"type": "string"
},
"observations": {
"description": "Canonical observations endpoint for this dataset.",
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"data",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
"additionalProperties": {}
}社群
證據
近期觀測
已驗證未記錄版本19 個工具
已驗證未記錄版本19 個工具
已驗證未記錄版本19 個工具