摘要
Tenderplan (tenderplan.ru) API 用于俄罗斯招标监控:通过你保存的关键字、标记找到的招标、带有协议、合同和投诉的完整招标数据、带有分析、评论、任务、包含 EGRUL 数据的组织、不可靠供应商注册、通知和招标日历的招标搜索。个人访问令牌。
引导式设置
2 分钟将 Tenderplan 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Tenderplan,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Tenderplan 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Tenderplan,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Tenderplan
Tenderplan (tenderplan.ru) API 用于俄罗斯招标监控:通过你保存的关键字、标记找到的招标、带有协议、合同和投诉的完整招标数据、带有分析、评论、任务、包含 EGRUL 数据的组织、不可靠供应商注册、通知和招标日历的招标搜索。个人访问令牌。
设置
设置大约需要 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,则该令牌无法使用任务。 - 未包含:订单、发票和费用购买、编辑关键字和标记、用户管理和文件上传。没有工具可以移动资金。
先决条件:TENDERPLAN_API_TOKEN
本地安装连接器
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
打开 http://localhost:3000/connectors/store,选择 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 的供应商。”
- “在该招标中添加评论:请在周五之前准备申请。”
- “我有哪些开放任务,下一周的招标截止日期在日历中?”
下一步
这份指南对你有帮助吗?