摘要
Tenderplan (tenderplan.ru) API 用于俄罗斯招标监控:通过你保存的关键字、标记找到的招标,包含协议、合同和投诉的完整招标数据,带有分析的招标搜索、评论、任务、带有 EGRUL 数据的组织、不可靠供应商注册、通知和招标日历。个人访问令牌。
引导式设置
2 分钟将 Tenderplan 连接到 Gemini
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Tenderplan,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Tenderplan 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Tenderplan,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Tenderplan + Gemini
Tenderplan (tenderplan.ru) API 用于俄罗斯招标监控:通过你保存的关键字、标记找到的招标,包含协议、合同和投诉的完整招标数据,带有分析的招标搜索、评论、任务、带有 EGRUL 数据的组织、不可靠供应商注册、通知和招标日历。个人访问令牌。
前提条件
请查看连接器中包含的完整设置说明(在你选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
TENDERPLAN_API_TOKEN
第一步 — 获取凭据
设置大约需要 3 分钟。
- 登录 https://tenderplan.ru/app 并打开你的个人资料设置,选项卡 Интеграции с сервисами(与服务的集成)。
- 在 Тендерплан API 区块中点击 Настроить(设置),在 Название токена 下输入名称,并勾选 Выберите права, которые будут передаваться по API 下的权限。对于所有工具,勾选
firm:read、user:read、users:read、keys:read、marks:read、relations:read、relations:write、resources:external、resources:personal、comments:read、comments:write、notifications:read和calendar:read。对于只读设置,省略两个write权限。 - 点击 Сгенерировать токен(生成令牌),复制令牌并粘贴到
TENDERPLAN_API_TOKEN中。你的令牌在 Мои токены 下列出,可以撤销。
你的 Tenderplan 角色必须被允许添加 API 访问;如果缺少 API 区块,请询问你公司的管理员。令牌以 Authorization: Bearer 形式发送。与 Tenderplan 注册的应用程序的 OAuth 2.0 访问令牌在同一字段中有效(仅适用于需要 resources:external 的工具的客户端凭据令牌);连接器不会更新令牌。
从哪里开始:tenderplan_get_firm 证明令牌有效,tenderplan_get_current_user 告诉它代表谁。tenderplan_list_keys(保存的搜索)和 tenderplan_list_marks(标签)提供 tenderplan_list_tenders 的 ID;tenderplan_get_tender 读取一个完整的招标。tenderplan_list_reference_values 翻译状态、投标方式、平台和地区的数字 ID。
招标:tenderplan_list_tenders 按一个关键字或标记列出监控的招标;tenderplan_filter_tenders 是更新的列表,带有状态、日期窗口、类型、评论和任务过滤器,tenderplan_list_saved_filters 显示用户为其保存的过滤器。tenderplan_search_tenders 使用关键条件搜索整个数据库,并返回招标或客户、参与者和产品的分析。tenderplan_find_tender_by_number 将通知编号转换为 Tenderplan ID。tenderplan_get_tender_related_info 一次返回一个招标的相关记录,tenderplan_list_tender_records 一次返回一种类型(协议、合同、阶段、说明、投诉、银行担保、РНП 条目、附件)。
团队合作:tenderplan_list_comments 和 tenderplan_add_comment;tenderplan_list_open_tasks、tenderplan_list_tender_tasks、tenderplan_add_task 和 tenderplan_complete_task;tenderplan_add_tender_marks 和 tenderplan_mark_tenders_read;tenderplan_list_users 用于用户 ID;tenderplan_list_notifications 和 tenderplan_list_calendar_events。tenderplan_remove_tender_marks 默认关闭:仅在助手可以从招标中移除标签时打开。
组织:tenderplan_search_organizations 按名称或 INN 查找客户或供应商;tenderplan_get_organization、tenderplan_get_organization_egrul 和 tenderplan_get_organization_contacts 读取其资料、注册数据和联系人;tenderplan_list_rnp_records 检查供应商是否在不可靠供应商注册中。
现场笔记
- 招标、关键字、标记、用户、任务、评论和组织的 ID 是 24 字符的十六进制字符串。通知编号(
number)是不同的东西:首先解析它。 - 日期 是 Unix 时间(毫秒)格式(
1647873410678),在过滤器和答案中。招标时间是时刻,而不是本地日期:为用户转换它们(莫斯科是 UTC+3)。 - 代码 是数字:
status1 接受投标,2 委员会在工作中,3 投标结束,4 取消,5 失败,6 执行结束,7 正在执行,8 终止;kind0 招标,1 计划日程条目,2 价格请求;placingWay、type(平台)和region来自参考列表。 - 价格:
maxPrice是招标的初始最大合同价格(НМЦ),以招标的currency表示。 - 分页:
page从 0 开始,页面大小由 Tenderplan 固定;继续读取,直到页面返回为空。打开任务页面使用cursor,组织使用from和size。 - 搜索词 在招标列表中需要至少 3 个字符。
- 未记录的答案:公共文档描述了搜索、评论、任务、РНП 和保存过滤器调用的答案;对于其他调用,请从答案本身读取字段。
- 速率限制:每个用户最多 100 次调用每 10 秒,500 次每 60 秒;招标列表每分钟 60 次,
tenderplan_get_tender每分钟 300 次。超出限制时,API 返回 429:等待一分钟。 - 权限:每个工具描述都列出了所需的权限;403 意味着令牌创建时没有该权限。任务工具需要
tasks:read和tasks:write,而已发布的权限列表未显示:如果它们返回 403,则该令牌无法使用任务。 - 不包括:订单、发票和关税购买、编辑关键字和标记、用户管理和文件上传。没有工具移动资金。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 Gemini 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list)—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
Tenderplan的工具。
可用工具
| 工具 | 功能 |
|---|---|
tenderplan_get_firm | 读取令牌所属的公司(公司账户):你的 Tenderplan 账户的公司记录。证明令牌有效的最便宜的调用… |
tenderplan_get_current_user | 读取令牌代表的用户:该用户自己的记录。使用用户的 _id 作为责任用户、任务受让人或在其他… |
tenderplan_list_users | 列出你在 Tenderplan 中的公司的用户。使用他们的 ID 作为 user_ids 过滤器、任务 assignee_id 和评论提及。无分页… |
tenderplan_list_keys | 列出公司的关键字:Tenderplan 持续运行的保存搜索以收集新招标。关键字有一个 ID、一个名称和搜索条件… |
tenderplan_list_marks | 列出公司的标记:用户在招标上放置的标签,以便对其进行分类和跟踪工作。将标记 ID 作为 mark_id 传递… |
tenderplan_list_tenders | 列出你公司监控的招标的简短模型,按一个关键字(保存的搜索)或一个标记(标签)过滤。文档描述了… |
tenderplan_filter_tenders | 列出监控的招标,使用更新的、更丰富的过滤器(列表版本 2):选择一个子集(按关键字、标记、用户、箱、法律请求或任务)… |
tenderplan_get_tender | 通过其 Tenderplan ID 读取一个招标的完整模型:Tenderplan 持有的关于通知的所有信息,超出列表的简短模型… |
tenderplan_get_tender_related_info | 一次读取一个招标周围发生的事情:Tenderplan 为其收集的相关记录,例如协议、合同和… |
tenderplan_list_tender_records | 列出附加到招标的某种类型的记录:协议、合同、合同阶段、说明(文档的澄清)… |
tenderplan_search_tenders | 使用关键条件搜索整个 Tenderplan 招标数据库(不仅仅是你监控的招标),并读取结果的分析… |
tenderplan_find_tender_by_number | 通过其通知编号(在 zakupki.gov.ru 或交易平台上的编号)在 Tenderplan 数据库中查找招标。使用它… |
tenderplan_list_saved_filters | 列出当前用户在 Tenderplan 中保存的列表过滤器(版本 2):按子集(type 0 关键字,1 标记,2 用户,3 箱,4 法律请求… |
tenderplan_list_comments | 列出你公司在一个招标上写的所有评论。返回 comments,包含 _id、text(纯文本或带有 blocks 的富文本对象)… |
tenderplan_add_comment | 以令牌用户的名义在招标上写评论。公司中的同事在 Tenderplan 中看到它,Tenderplan 有新评论的通知… |
tenderplan_list_open_tasks | 列出你公司所有招标的开放任务。返回 tasks,包含 _id、name、desc(备注)、tenderId、assigneeId、dueAt… |
tenderplan_list_tender_tasks | 列出一个招标的任务和部分,包括开放和关闭的任务。返回 tasks(_id、name、desc、assigneeId、dueAt、dueCompleteAt… |
tenderplan_add_task | 向招标添加任务,可选地指定受让人、截止日期和提醒。返回存储的任务及其 _id、createdBy 和… |
tenderplan_complete_task | 关闭一个招标的任务,或重新打开一个已关闭的任务。返回任务,dueCompleteAt 在关闭时设置。需要 tasks:write… |
tenderplan_search_organizations | 按名称或 INN 搜索 Tenderplan 知道的客户(买方)和供应商(参与者)。使用组织 ID… |
tenderplan_get_organization | 通过其 Tenderplan 组织 ID 读取一个组织(客户或供应商)的卡片:Tenderplan 持有的关于该法人实体的信息… |
tenderplan_get_organization_egrul | 从俄罗斯国家法人注册(ЕГРЮЛ, EGRUL)读取一个组织的数据:其分支、代表处… |
tenderplan_get_organization_contacts | 读取 Tenderplan 从其招标中收集的一个组织的联系人。这可能包括联系人的个人数据:使用… |
tenderplan_list_rnp_records | 列出一个供应商在不可靠供应商注册中的条目(РНП,版本 2)。每个条目都有 _id、id(注册号)… |
tenderplan_list_notifications | 列出当前用户的通知,作为简短的招标模型(版本 2):tenders 包含通知所涉及的招标。按… |
tenderplan_list_calendar_events | 列出公司招标日历中在时间窗口内的事件(版本 2):你公司监控的招标的日期事件。两端… |
tenderplan_list_reference_values | 读取 Tenderplan 的参考列表之一,以翻译招标和过滤器中的数字 ID:状态(9 行:_id、name… |
tenderplan_add_tender_marks | 在招标上放置一个或多个标记(标签),保留它已经拥有的标记。Tenderplan 对标记的招标有通知,因此… |
tenderplan_mark_tenders_read | 将招标标记为令牌用户已读,方式与在 Tenderplan 中打开它们相同。每次调用最多 100 个招标。答案未描述… |
tenderplan_remove_tender_marks | 从招标中移除标记(标签)。默认关闭:移除标记会将招标从该标签的列表中删除,适用于整个公司。… |
示例提示
- "我的关键字 Медицинское оборудование 本周发现了哪些新招标,最大价格是多少?"
- "显示招标 0373100012325000123 及其协议和合同。"
- "在不可靠供应商注册中检查 INN 为 7701234567 的供应商。"
- "在该招标上添加评论:请在周五之前准备申请。"
- "我有哪些开放任务,以及下周日历中的招标截止日期是什么?"
常见问题
令牌来自哪里? 在 Tenderplan 中打开你的个人资料设置,选项卡 Интеграции с сервисами,区块 Тендерплан API,点击 Настроить,命名令牌,勾选工具所需的权限,然后点击 Сгенерировать токен。你的 Tenderplan 角色必须被允许添加 API 访问;如果缺少该区块,请询问你公司的管理员。
它涵盖了什么? 通过你保存的关键字和标记找到的招标,包含协议、合同、说明、投诉和银行担保的完整招标数据,跨整个数据库的搜索及分析、评论、任务、带有 EGRUL 数据和联系人的组织、不可靠供应商注册、通知和招标日历。不包括订单、发票、关税购买、编辑关键字和标记、用户管理和文件上传;没有工具移动资金。
哪些工具默认关闭? tenderplan_remove_tender_marks,它会从招标中移除标签。仅在 AI 应该使用时在连接器页面上打开它。对于只读设置,创建令牌时不包含两个写权限。
Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?