SECOP II - Buscador Inteligente de Licitaciones Colombia 🇨🇴

Encuentra licitaciones y contratos del Estado colombiano usando Inteligencia Artificial. Este Actor busca en el portal SECOP II (Sistema Electrónico de Contratación Pública), filtra los resultados relevantes para tu negocio y los puntúa automáticamente con Claude o GPT.

Ideal para: proveedores del Estado, consultores, empresas de ingeniería, tecnología, servicios profesionales y cualquier organización que quiera ganar contratos públicos en Colombia.

---

¿Qué hace este Actor?

1. Expande tu búsqueda con IA — Tomas una palabra clave simple (ej. "software") y la IA genera variantes sinónimas para no perderte ninguna licitación relevante.
2. Consulta SECOP II en tiempo real — Busca directamente en el dataset oficial de datos.gov.co con los filtros que tú configures.
3. Filtra lo irrelevante — Descarta licitaciones que no coincidan con tu perfil de negocio.
4. Puntúa cada resultado — Asigna un score de 1–10 a cada licitación según su relevancia, justificando la calificación.
5. Entrega solo lo relevante — Solo guarda en el dataset los resultados con score alto, así pagas únicamente por valor real.

---

💡 Casos de uso

• Empresa de software: busca contratos de desarrollo, sistemas de información o transformación digital en entidades públicas.
• Consultor independiente: encuentra licitaciones de consultoría, estudios o interventorías en su área de especialidad.
• Empresa de construcción: rastrea contratos de obra civil, mantenimiento o infraestructura por departamento.
• Firma legal: identifica oportunidades de asesoría jurídica, representación o servicios notariales.
• Startup de IA: detecta proyectos de innovación, analítica de datos o automatización en el sector público.

---

⚙️ Parámetros de entrada (Input)

Parámetro	Tipo	Descripción
searchQuery	string	Palabra clave principal para buscar (ej. "desarrollo de software")
maxResults	number	Máximo de resultados a evaluar (default: 20, max: 100)
minBudget	number	Presupuesto mínimo en COP (opcional, ej. 5000000)
maxBudget	number	Presupuesto máximo en COP (opcional)
department	string	Filtrar por departamento colombiano (opcional, ej. "Bogotá D.C.")
dateFrom	string	Fecha desde (YYYY-MM-DD, opcional)
aiProvider	string	Motor de IA: "claude" o "openai" (default: "claude")
aiApiKey	string	API key de Claude (Anthropic) u OpenAI
relevanceThreshold	number	Score mínimo para guardar resultado (1–10, default: 6)

Ejemplo de input

{
  "searchQuery": "desarrollo de software",
    "maxResults": 30,
      "minBudget": 10000000,
        "department": "Bogotá D.C.",
          "aiProvider": "claude",
            "aiApiKey": "sk-ant-...",
              "relevanceThreshold": 6
              }
              ```

              ---

              ## 📦 Estructura del output

              Cada licitación guardada en el dataset contiene:

              ```json
              {
                "id": "ID-2024-001234",
                  "nombre": "Contratar servicios de desarrollo de software para sistema de información",
                    "entidad": "Ministerio de Tecnologías de la Información",
                      "departamento": "Bogotá D.C.",
                        "presupuesto": 85000000,
                          "fechaLimite": "2026-07-15",
                            "urlSecop": "https://www.secop.gov.co/...",
                              "score": 9,
                                "justificacion": "Alta relevancia: contrato de desarrollo de software a medida para entidad del gobierno central, presupuesto adecuado y plazo vigente.",
                                  "estado": "Convocado"
                                  }
                                  ```

                                  ---

                                  ## 💰 Precios

                                  Este Actor usa el modelo **Pay per result** — solo pagas por las licitaciones relevantes que recibas.

                                  | Evento | Precio |
                                  |---|---|
                                  | Por licitación relevante entregada | **$0.15 USD** |
                                  | Inicio del Actor | $0.00005 USD |

                                  **Ejemplo real:**
                                  - Buscas `"interventoría vial"` → el Actor encuentra 8 licitaciones relevantes → pagas **$1.20 USD**
                                  - Tu ganancia potencial: si ganas uno de esos contratos, puede valer decenas de millones de pesos.

                                  > 💡 **Tip:** Usa el parámetro `maxResults` para controlar cuántas licitaciones evalúa el Actor y así limitar el costo por corrida.

                                  ---

                                  ## 🚀 Cómo empezar

                                  ### Opción 1: Desde Apify Console (sin código)
                                  1. Haz clic en **"Try for free"** o **"Start"**
                                  2. Ingresa tu palabra clave en `searchQuery`
                                  3. Agrega tu API key de Claude o OpenAI
                                  4. Ajusta los filtros opcionales (departamento, presupuesto, fechas)
                                  5. Haz clic en **"Run"** y espera los resultados

                                  ### Opción 2: Via API
                                  ```bash
                                  curl -X POST "https://api.apify.com/v2/acts/alijosecruz~my-actor/runs?token=TU_TOKEN_APIFY" \
                                    -H "Content-Type: application/json" \
                                      -d '{
                                          "searchQuery": "consultoría tecnológica",
                                              "maxResults": 20,
                                                  "aiProvider": "claude",
                                                      "aiApiKey": "sk-ant-TU_KEY"
                                                        }'
                                                        ```

                                                        ### Opción 3: Integración con Zapier / Make
                                                        Conecta el Actor a tu CRM, Slack o email para recibir alertas automáticas de nuevas licitaciones relevantes cada día.

                                                        ---

                                                        ## 🔗 Fuente de datos

                                                        Los datos provienen del **dataset oficial de SECOP II** publicado en [datos.gov.co](https://www.datos.gov.co/), el portal de datos abiertos del gobierno colombiano. El dataset se actualiza diariamente con nuevos procesos de contratación pública.

                                                        ---

                                                        ## 🛡️ Notas técnicas

                                                        - El Actor **no guarda** tu API key de IA en ningún log público.
                                                        - Los resultados son **privados** — solo tú los ves en tu cuenta Apify.
                                                        - Compatible con **Claude 3 Haiku/Sonnet** (Anthropic) y **GPT-4o-mini/GPT-4** (OpenAI).
                                                        - Tiempo promedio de ejecución: 2–5 minutos por búsqueda.

                                                        ---

                                                        ## 📬 Soporte

                                                        ¿Tienes preguntas o encuentras algún problema? Abre un Issue en este Actor o contáctanos directamente a través de Apify.

                                                        **Crafted by [Ali Cruz](https://apify.com/alijosecruz)** 🇨🇴