安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install editalmd
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 editalmd。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

EditalMD 连接到巴西国家公共采购门户网站 PNCP，使代理商能够按产品、服务和州搜索招标；审查采购记录、提案截止日期、供应商和中标价格摘要；并查找有效的价格注册纪要和计划采购。它对探索如何向巴西政府销售的以及跟踪采购机会的团队非常有用。
作为用于采购研究的 Openclaw Skills 之一，EditalMD 还可以提供带有资格要求和页面证据的 Markdown 格式招标书。基本搜索和采购信息可免费获取，而处理后的文件分析则需要付费访问。原始文件仍然免费提供。

应用场景

在决定是否参与之前，按产品、服务或巴西各州查找公开招标。
审查采购的机构、标的物、金额、文件和提案截止日期。
估计对招标提出异议的最后一天，同时在原始 edital 中确认日期。
研究通常赢得类似采购的 CNAE 活动并比较同源价格。
查找有效的价格注册纪要，检查是否接受加盟，并审查机构的年度采购计划。
将 edital 读取为 Markdown，并通过页面证据提取资格要求、项目、截止日期和义务。
通过搜索词、州或公司 CNPJ 为新招标创建警报，并关注采购更新。

工作原理

通过首选的 Streamable HTTP MCP 服务器连接或直接调用 HTTPS API。
从免费搜索和研究工具开始，查找招标并检查采购记录、截止日期、供应商活动、价格、纪要和计划。
对于文件，检查其元数据并调用 estado_geracao 以检索页数、处理状态和价格报价。
向用户展示报价，仅在用户批准并购买访问权限后才进行付费处理。代理不得代表用户付款。
使用返回的私有 acesso_codigo 将文件读取为 Markdown 或请求资格分析和带有页面证据的 dossier。
如果处理返回 HTTP 202，请等待 Retry-After 间隔并使用 estado_geracao 检查状态；请勿重复生成 POST 以轮询进度。
要跟踪机会，请创建一个所有者令牌并使用它来创建警报或采购监视，然后检索匹配的招标或记录的事件。

配置指南

使用 EditalMD MCP 端点连接，如果 MCP 工具不可用，则使用 HTTPS API。搜索和采购记录工具不需要密钥。网站结账 MCP 连接允许用户在网站上进行购买，而不是让代理付款。

Discover available API routes, prices, and limits

curl -s https://editalmd.com/api/

Search tenders for school uniforms in São Paulo state

curl -s 'https://editalmd.com/api/busca?q=uniforme%20escolar&uf=SP'

Read a purchase record, including deadlines and documents

curl -s https://editalmd.com/api/compra/28870493

Get a winning-price summary for a similar item

curl -s 'https://editalmd.com/api/precos?q=papel%20A4'
在请求付费文件处理之前，请阅读报价和页数，然后获得用户的批准。用户可以在 https://editalmd.com/pricing 购买计划或预付费额度。保持访问代码和令牌机密；请勿将其暴露在日志、文件或响应中。对于警报和监视，创建一次所有者令牌并将其传递为 Authorization: Bearer edm_…。

数据架构

Procurement records: 搜索结果来自 PNCP，可包括采购标识符、标的物、机构、金额、日期和文件参考。记录可能已关闭，因此请在采取行动前检查其截止日期。
Search and list pagination: 结果每页最多返回 20 个项目；遵循下一页链接而不是抓取 HTML。
Document metadata and content: 文件端点提供标题、类型和页数。原始文件在 /api/documento/{id}/original 免费；处理后的 Markdown 和分析需要访问权限。生成的 Markdown 包含源和哈希信息。
Document analysis: 资格要求、dossier 项目、截止日期和义务可以包括文字摘录和页面证据。检查覆盖范围字段：缺少或部分 dossier 内容并不证明要求不存在。
Market research: 价格摘要可以报告样本数量、中位数和范围。其他数据包括赢得招标的 CNAE 活动、有效的价格注册纪要和计划采购。
Alerts and watches: 警报存储匹配的招标标准或公司活动标准；监视跟踪采购更改，例如新文件、暂停、截止日期更改或价值更改。这些功能需要所有者令牌。
Access and usage metadata: 处理使用每页单位，而价格报告、警报和监视具有其自身的单位成本。GET /api/plans 报告账户使用情况。必须保护私有的 acesso_codigo、cred_… 和 edm_… 令牌。

高级特性

MCP and HTTP access:
使用 Streamable HTTP MCP 服务器或直接调用相应的 API 路由；API 根目录和
llms-full.txt
提供路由和参考发现。
Document evidence workflows:
在授权处理后，检索带有文字摘录和页面参考的 Markdown、资格要求和结构化 dossier 详细信息。
Opportunity monitoring:
创建术语和州警报、基于 CNPJ 的警报以及针对单个采购变更的监视。
Pricing and access controls:
在购买前检查处理报价和当前定价；预付费访问代码允许在无需额外费用的情况下授权重新打开文件。
Evaluation options:
该 service 记录了一个有限的免费代理评估，其中包含一个赞助的高级文件和最多 100 次基本读取，受规定的页数限制和可用性限制。
Responsible retries and estimates:
在 HTTP 202、429 或 503 响应上遵守
Retry-After
。将异议截止日期视为会议前三个工作日的估计值，并在 edital 中确认。
Data-quality safeguards:
原始源文件仍然可用，但自动处理的 Markdown 未经认证与原件相同；根据源文件验证重要细节。

name: editalmd description: Work with Brazilian public procurement (licitações, PNCP) through EditalMD (editalmd.com). Search tenders by product, service and state, read the proposal deadline and the estimated last day to challenge, see which activities (CNAE) usually win, winning prices, valid price-registration minutes (atas) and annual purchase plans. Read a tender document (edital) as Markdown with the qualification requirements and page evidence, and create alerts for new tenders and watches on a purchase. Use when a task mentions licitação, edital, pregão, PNCP, compras públicas, Lei 14.133, ata de registro de preço or selling to the Brazilian government. license: MIT-0
compatibility: Needs HTTPS access to editalmd.com. Works with the remote MCP server or with plain HTTP calls.

EditalMD

EditalMD collects the public purchases of Brazil from the national procurement portal (PNCP). Use it to find tenders, check their deadlines and prices, and read the tender documents as Markdown. Original files are free at GET /api/documento/{id}/original. PDFs open inline; other formats download. Processed content and requirement analysis use the paid document access.

Connect

HTML index pages are free for people and crawlers, without an API quota. JSON, Markdown, OKF and MCP index data calls have 1,000 free reads per day, IP and product. Above that allowance, US$1 buys 1,000 shared reads for 30 days without automatic renewal. See /api-access-guide.md for evaluation, purchase and retry instructions.

MCP server (preferred): https://editalmd.com/mcp?checkout=site. Transport: Streamable HTTP. Search and records need no key. With checkout=site, the person buys on the site and the agent never pays.
HTTP API: base URL https://editalmd.com. Each MCP tool calls one route of this API.

If the MCP tools are not available, call the HTTP routes with curl or with your fetch tool.

Discovery: GET https://editalmd.com/api/ lists the routes, prices and limits. https://editalmd.com/llms-full.txt has the full reference.

MCP tools

Tool HTTP Use it to Cost

consulta_cadastro GET /api/consulta/cadastro/{cnpj} Read basic company data without contacts or live analysis. Free, no allowance consumed
consulta_endereco GET /api/consulta/endereco/{cep} Read up to 20 addresses and 20 companies of a CEP. Free, no allowance consumed
buscar_licitacao GET /api/busca Find purchases by term (q) and state (uf). Set abertas to keep only open proposals. Free
compra GET /api/compra/{id} Read a purchase: object, agency, value, dates and its documents. Free
prazos GET /api/compra/{id} Read the proposal deadline and the estimated last day to challenge (Lei 14.133, art. 164). Free
quem_fornece GET /api/compra/{id}/cnaes See which activities (CNAE) usually win purchases like this one. Free
abertas_do_ramo GET /api/compra/{id}/abertas List open tenders of the same line of business from the last 7 days. Free
precos_homologados GET /api/precos Get the winning price of a similar item: count, median and range. Free summary
atas_vigentes GET /api/atas Find valid price-registration minutes and see if they accept adhesion. Free
planos_de_compras GET /api/planos See what agencies plan to buy before the tender opens. Free
exemplos GET /api/exemplos Get five processed sample documents. Free
documento GET /api/documento/{id} Read the title, type and page count of a document. Free
estado_geracao GET /api/documento/{id}/geracao Read the price quote (cotacao) and the progress of a document. Free
gerar_markdown POST /api/documento/{id}/geracao Get access to one document with the person's prepaid credit. Send the cotacao that you read. Per page
edital_markdown GET /api/documento/{id}/markdown Read the document as Markdown with source and hash. Send acesso_codigo. With access
habilitacao POST /api/documento/{id}/habilitacao List the qualification requirements with literal excerpts. With access
documento_dossie GET /api/documento/{id}/dossie Read items, requirements, deadlines and obligations with page evidence. With access
criar_dono POST /api/dono Create the owner token edm_… for alerts and watches. You see it one time only. Free
criar_alerta POST /api/alertas Create an alert for new tenders by terms and state. First one free
alerta_por_cnpj POST /api/alertas Create alerts from the activities of a company (CNPJ). First one free
alertas_compras GET /api/alertas/{id}/compras Read the tenders that matched an alert. Free
vigiar_compra POST /api/vigias Watch one purchase for a new document, suspension, new deadline or new value. First one free
vigia_eventos GET /api/vigias/{id}/eventos Read the changes of a watched purchase. Free
pricing GET /api/pricing Read the current prices and free allowances. Free
list_plans GET /api/plans Read the analysis packages and the account's current plan. Free
cancel_plan POST /api/plans/cancel Cancel the plan after reviewing its loss and refund conditions. No new purchase

Rules

Start with the free tools: search, purchase record, deadlines, suppliers and prices.
Before you buy processed content or analysis, call estado_geracao. Show the page count and the total of cotacao to the user. Call gerar_markdown only after the user approves that amount.
Each buyer pays for its own access. gerar_markdown returns a private acesso_codigo. Keep it and send it to the reading tools. With it, you open the document again at no cost.

If gerar_markdown returns HTTP 202, wait for the time in Retry-After. Then read estado_geracao (GET). Do not send the POST again to check the progress.

Alerts and watches need the owner token. Create it once with criar_dono and keep it secret. Send it as header Authorization: Bearer edm_… (HTTP request or MCP connection header).
Never pay by yourself. If a call returns HTTP 402, show the price and https://editalmd.com/pricing to the user. The person buys on the site. After the purchase, send the same call again with the person's prepaid credit token (credito_token argument or header X-Credito: cred_…). Keep the same idempotencia value when you retry.
Keep tokens (cred_…, edm_…, whsec_…) and access codes secret. Do not write them in files, logs or answers unless the user asks you to save them.
The challenge deadline is an estimate: 3 business days before the session, with national holidays only. Tell the user to confirm it in the tender document.
A missing or partial dossier does not mean that the tender has no requirements. Read its coverage fields.
Lists return up to 20 items per page. Follow the next-page links. Do not scrape HTML pages.

If you get HTTP 429 or 503, wait for the time in Retry-After and try once more.

Free evaluation for agents

An agent can test the document service without payment: one sponsored premium document and up to 100 basic reads, up to 50 pages each, for a limited time. The guide is https://editalmd.com/avaliacao.md. The tools are avaliacao_cotas, avaliacao_premium and avaliacao_basico.

Buy

The person buys on the site: https://editalmd.com/pricing shows the plans and the prepaid credit, with the prices. Pay as you go has no monthly fee. Basic includes 1,000 units for R$ 97 (pro-paginas). Professional includes 10,000 for R$ 797 (profissional-paginas). Enterprise includes 100,000 for R$ 5,997 (empresarial-paginas). Each paid plan includes requirements, deadlines, obligations, company-document comparison and processed reading. New plan purchases require server-authorized testing. Card subscriptions renew monthly only after explicit consent. Pix, USDC and balance purchases last 30 days without renewal. Unused units expire at the end of the period. Each document can have up to 200 pages. Original PDFs remain free.
The allowance uses 1 unit per page, 25 per price report, 5 per alert and 3 per tender watch. The first alert and watch remain free. Human services and API access packages are separate. GET /api/plans returns account.active.usage with total, used and remaining units. A signed-in person opens a report with POST /api/precos/detalhe and CSRF protection. The server uses allowance before prepaid credit. Reopening the same report in the period uses no more units.
The site-checkout MCP connection does not expose buy_plan. Send the person to the site to select a plan.
pricing and estado_geracao read the prices and the quote. They do not charge.
A prepaid credit gives a cred_… token one time only. The same token works in EditalMD, Radar CNPJ and PontoFato.

Examples

# Tenders for school uniforms in São Paulo state (free)
curl -s 'https://editalmd.com/api/busca?q=uniforme%20escolar&uf=SP'

# Purchase record with deadlines and documents (free)
curl -s https://editalmd.com/api/compra/28870493

# Winning price summary of a similar item (free)
curl -s 'https://editalmd.com/api/precos?q=papel%20A4'

Limits

Read procurement news at https://editalmd.com/en/noticias/index.md. The free feed is https://editalmd.com/en/noticias/feed.json. Cite the article date and original sources.

The source is PNCP. A purchase in the data can be closed already: read prazos before you act.

The Markdown comes from the original files. Automatic review has quality indicators but does not certify that the text is identical to the original.

Terms: https://editalmd.com/termos. Privacy: https://editalmd.com/privacidade. Contact: contato@editalmd.com.

LION 支付前筛选
麦当劳套餐规划委员会