Resumen
API de Tenderplan (tenderplan.ru) para el monitoreo de licitaciones en Rusia: licitaciones encontradas por tus claves guardadas, marcas, datos completos de licitaciones con protocolos, contratos y quejas, búsqueda de licitaciones con análisis, comentarios, tareas, organizaciones con datos de EGRUL, el registro de proveedores no confiables, notificaciones y el calendario de licitaciones. Token de acceso personal.
Configuración guiada
Conecta Tenderplan a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Tenderplan con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Tenderplan
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Tenderplan, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Tenderplan
API de Tenderplan (tenderplan.ru) para el monitoreo de licitaciones en Rusia: licitaciones encontradas por tus claves guardadas, marcas, datos completos de licitaciones con protocolos, contratos y quejas, búsqueda de licitaciones con análisis, comentarios, tareas, organizaciones con datos de EGRUL, el registro de proveedores no confiables, notificaciones y el calendario de licitaciones. Token de acceso personal.
Configuración
La configuración toma aproximadamente 3 minutos.
- Inicia sesión en https://tenderplan.ru/app y abre la configuración de tu perfil, pestaña Интеграции с сервисами (Integraciones con servicios).
- En el bloque Тендерплан API haz clic en Настроить (Configurar), escribe un nombre bajo Название токена y marca los permisos bajo Выберите права, которые будут передаваться по API. Para todas las herramientas marca
firm:read,user:read,users:read,keys:read,marks:read,relations:read,relations:write,resources:external,resources:personal,comments:read,comments:write,notifications:readycalendar:read. Para una configuración de solo lectura, deja fuera los dos permisoswrite. - Haz clic en Сгенерировать токен (Generar token), copia el token y pégalo en
TENDERPLAN_API_TOKEN. Tus tokens están listados bajo Мои токены, donde un token puede ser revocado.
Tu rol en Tenderplan debe tener permiso para agregar acceso a la API; si falta el bloque de API, pregunta al administrador de tu empresa. El token se envía como Authorization: Bearer. Un token de acceso OAuth 2.0 de una aplicación registrada en Tenderplan funciona en el mismo campo (un token de credenciales de cliente solo para las herramientas que necesitan resources:external); el conector no renueva tokens.
Dónde empezar: tenderplan_get_firm prueba que el token funciona y tenderplan_get_current_user indica para quién actúa. tenderplan_list_keys (búsquedas guardadas) y tenderplan_list_marks (etiquetas) dan los ids para tenderplan_list_tenders; tenderplan_get_tender lee una licitación en su totalidad. tenderplan_list_reference_values traduce los ids numéricos para estado, forma de colocación, plataforma y región.
Licitaciones: tenderplan_list_tenders lista las licitaciones monitoreadas por una clave o marca; tenderplan_filter_tenders es la lista más nueva con filtros de estado, ventana de fechas, tipo, comentario y tarea, y tenderplan_list_saved_filters muestra los filtros que el usuario guardó para ello. tenderplan_search_tenders busca en toda la base de datos con condiciones clave y devuelve licitaciones o análisis sobre clientes, participantes y productos. tenderplan_find_tender_by_number convierte un número de aviso en un id de Tenderplan. tenderplan_get_tender_related_info devuelve los registros relacionados de una licitación en una sola llamada, tenderplan_list_tender_records un tipo a la vez (protocolos, contratos, etapas, explicaciones, quejas, garantías bancarias, entradas de РНП, adjuntos).
Trabajo en equipo: tenderplan_list_comments y tenderplan_add_comment; tenderplan_list_open_tasks, tenderplan_list_tender_tasks, tenderplan_add_task y tenderplan_complete_task; tenderplan_add_tender_marks y tenderplan_mark_tenders_read; tenderplan_list_users para ids de usuarios; tenderplan_list_notifications y tenderplan_list_calendar_events. tenderplan_remove_tender_marks está instalado apagado: actívalo solo si el asistente puede quitar etiquetas de las licitaciones.
Organizaciones: tenderplan_search_organizations encuentra un cliente o proveedor por nombre o INN; tenderplan_get_organization, tenderplan_get_organization_egrul y tenderplan_get_organization_contacts leen su perfil, datos del registro y personas de contacto; tenderplan_list_rnp_records verifica un proveedor contra el registro de proveedores no confiables.
Notas de campo
- Ids de licitaciones, claves, marcas, usuarios, tareas, comentarios y organizaciones son cadenas hexadecimales de 24 caracteres. El número de aviso (
number) es algo diferente: resuélvelo primero. - Fechas son tiempo Unix en milisegundos (
1647873410678), en filtros y en respuestas. Los tiempos de licitación son momentos, no fechas locales: conviértelos para el usuario (Moscú es UTC+3). - Códigos son números:
status1 aceptando ofertas, 2 comisión en trabajo, 3 colocación finalizada, 4 cancelada, 5 fallida, 6 ejecución finalizada, 7 en ejecución, 8 terminada;kind0 licitación, 1 entrada de plan de programación, 2 solicitud de precio;placingWay,type(plataforma) yregionprovienen de las listas de referencia. - Precios:
maxPricees el precio máximo inicial del contrato (НМЦ) en lacurrencyde la licitación. - Paginación:
pagecomienza en 0 y el tamaño de la página es fijo por Tenderplan; sigue leyendo hasta que una página regrese vacía. Abre la página de tareas concursor, organizaciones confromysize. - Palabras de búsqueda en listas de licitaciones necesitan al menos 3 caracteres.
- Respuestas no documentadas: la documentación pública describe las respuestas de las llamadas de búsqueda, comentario, tarea, РНП y filtros guardados; para las otras llamadas lee los campos de la respuesta misma.
- Límites de tasa: como máximo 100 llamadas en 10 segundos y 500 en 60 segundos por usuario; listas de licitaciones 60 por minuto,
tenderplan_get_tender300 por minuto. Si superas el límite, la API responde 429: espera un minuto. - Permisos: cada descripción de herramienta nombra el permiso que necesita; un 403 significa que el token fue creado sin él. Las herramientas de tareas necesitan
tasks:readytasks:write, que la lista de permisos publicada no muestra: si responden 403, este token no puede usar tareas. - No incluido: pedidos, facturas y compras de tarifas, edición de claves y marcas, administración de usuarios y cargas de archivos. Ninguna herramienta mueve dinero.
Requisitos previos: TENDERPLAN_API_TOKEN
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Tenderplan y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
tenderplan_get_firm | Lee la firma (cuenta de empresa) a la que pertenece el token: el registro de la firma de tu cuenta de Tenderplan. La llamada más barata para probar que el token… |
tenderplan_get_current_user | Lee el usuario para el que actúa el token: el propio registro de ese usuario. Usa el _id del usuario como usuario responsable, asignado a la tarea o mención en los otros… |
tenderplan_list_users | Lista los usuarios de tu firma en Tenderplan. Usa sus ids para filtros user_ids, como assignee_id de tarea y para menciones en comentarios. Sin paginación… |
tenderplan_list_keys | Lista las claves de la firma: las búsquedas guardadas que Tenderplan ejecuta continuamente para recopilar nuevas licitaciones. Una clave tiene un id, un nombre y condiciones de búsqueda… |
tenderplan_list_marks | Lista las marcas de la firma: las etiquetas que los usuarios ponen en las licitaciones para clasificarlas y rastrear el trabajo sobre ellas. Pasa un id de marca como mark_id para… |
tenderplan_list_tenders | Lista los modelos cortos de las licitaciones que tu firma monitorea, filtradas por una clave (búsqueda guardada) o una marca (etiqueta). La documentación describe el… |
tenderplan_filter_tenders | Lista las licitaciones monitoreadas con el filtro más nuevo y rico (versión de lista 2): elige un subconjunto (por clave, marca, usuario, bin, solicitudes legales o tareas)… |
tenderplan_get_tender | Lee el modelo completo de una licitación por su id de Tenderplan: todo lo que Tenderplan tiene sobre el aviso, más allá del modelo corto de la lista… |
tenderplan_get_tender_related_info | Lee lo que sucedió alrededor de una licitación en una sola llamada: los registros relacionados que Tenderplan recopiló para ella, como protocolos, contratos y… |
tenderplan_list_tender_records | Lista un tipo de registro adjunto a una licitación: protocolos, contratos, etapas de contrato, explicaciones (aclaraciones de la documentación)… |
tenderplan_search_tenders | Busca en toda la base de datos de licitaciones de Tenderplan (no solo tus licitaciones monitoreadas) con condiciones clave, y lee los análisis del resultado.… |
tenderplan_find_tender_by_number | Encuentra licitaciones por su número de aviso (el número en zakupki.gov.ru o en la plataforma de trading) en cualquier lugar de la base de datos de Tenderplan. Úsalo… |
tenderplan_list_saved_filters | Lista los filtros de lista que el usuario actual guardó en Tenderplan (versión 2): por subconjunto (type 0 clave, 1 marca, 2 usuario, 3 bin, 4 solicitudes legales… |
tenderplan_list_comments | Lista todos los comentarios que tu firma escribió sobre una licitación. Devuelve comments con _id, text (texto plano o un objeto de texto enriquecido con blocks)… |
tenderplan_add_comment | Escribe un comentario sobre una licitación en nombre del usuario del token. Los colegas en la firma lo ven en Tenderplan, que tiene una notificación para nuevos… |
tenderplan_list_open_tasks | Lista las tareas abiertas en todas las licitaciones de tu firma. Devuelve tasks con _id, name, desc (notas), tenderId, assigneeId, dueAt… |
tenderplan_list_tender_tasks | Lista las tareas y secciones de una licitación, abiertas y cerradas. Devuelve tasks (_id, name, desc, assigneeId, dueAt, dueCompleteAt… |
tenderplan_add_task | Agrega una tarea a una licitación, opcionalmente con un asignado, una fecha de vencimiento y un recordatorio. Devuelve la tarea almacenada con su _id, createdBy y… |
tenderplan_complete_task | Cierra una tarea de una licitación, o reabre una cerrada. Devuelve la tarea con dueCompleteAt establecido cuando se cierra. Necesita el tasks:write… |
tenderplan_search_organizations | Busca las organizaciones que Tenderplan conoce como clientes (compradores) y proveedores (participantes), por nombre o por INN. Usa el id de la organización de… |
tenderplan_get_organization | Lee la tarjeta de una organización (cliente o proveedor) por su id de organización de Tenderplan: lo que Tenderplan tiene sobre esa entidad legal.… |
tenderplan_get_organization_egrul | Lee datos de una organización del registro estatal ruso de entidades legales (ЕГРЮЛ, EGRUL): sus sucursales, oficinas representativas… |
tenderplan_get_organization_contacts | Lee los contactos de una organización tal como Tenderplan los recopiló de sus licitaciones. Esto puede incluir datos personales de las personas de contacto: usa… |
tenderplan_list_rnp_records | Lista las entradas de un proveedor en el registro de proveedores no confiables (РНП, versión 2). Cada entrada tiene _id, id (número de registro)… |
tenderplan_list_notifications | Lista las notificaciones del usuario actual como modelos cortos de licitaciones (versión 2): tenders con las licitaciones sobre las que son las notificaciones. Filtra por… |
tenderplan_list_calendar_events | Lista los eventos del calendario de licitaciones de la firma en una ventana de tiempo (versión 2): los eventos fechados de las licitaciones que tu firma monitorea. Ambos extremos… |
tenderplan_list_reference_values | Lee una de las listas de referencia de Tenderplan para traducir los ids numéricos en licitaciones y filtros: estados (9 filas: _id, name… |
tenderplan_add_tender_marks | Coloca una o más marcas (etiquetas) en una licitación, manteniendo las marcas que ya tiene. Tenderplan tiene una notificación para las licitaciones marcadas, así que… |
tenderplan_mark_tenders_read | Marca las licitaciones como leídas para el usuario del token, de la misma manera que abrirlas en Tenderplan. Hasta 100 licitaciones por llamada. La respuesta no está descrita… |
tenderplan_remove_tender_marks | Quita marcas (etiquetas) de una licitación. Instalado apagado: quitar una marca elimina la licitación de la lista de esa etiqueta para toda la firma. La… |
Ejemplos de solicitudes
- "¿Qué nuevas licitaciones encontró mi clave Медицинское оборудование esta semana, con el precio máximo?"
- "Muestra la licitación 0373100012325000123 con sus protocolos y contratos."
- "Verifica al proveedor con INN 7701234567 en el registro de proveedores no confiables."
- "Agrega el comentario: prepara la solicitud para el viernes, a esa licitación."
- "¿Qué tareas están abiertas para mí, y qué plazos de licitación están en el calendario la próxima semana?"
Próximos pasos
¿Te ha sido útil esta guía?