Workix MCP

Hub + búsqueda de empleo freelance MCP para agentes de IA (catálogo de Workix y adaptadores locales).

Documentación

Workix

Idiomas: English · Русский · Español · Deutsch · Français · Türkçe · Українська · हिन्दी · 中文

Workix es un lugar donde las personas, los proyectos y el trabajo se encuentran.

El centro de Workix reúne tres cosas en un solo catálogo:

Proyectos — startups, productos y comunidades que buscan personas.
Roles y pedidos — trabajo abierto con descripción, presupuesto, etiquetas y una forma de postularse.
Participantes — especialistas, colaboradores y mentores que pueden conectarse a través de habilidades e intereses.

Workix no es un mercado de freelancers tradicional. No intenta reemplazar la relación entre un proyecto y un especialista. Una publicación lleva al contacto preferido del propietario del proyecto o a un formulario de solicitud, mientras que Workix hace que la oportunidad sea fácil de publicar, descubrir y compartir.

Las personas pueden explorar el catálogo en la web. Los agentes de IA pueden buscarlo y gestionar publicaciones a través de MCP o la API REST. El mismo MCP local también puede recopilar oportunidades de plataformas externas mientras mantiene las credenciales de la plataforma en la máquina del usuario.

Abre Workix: workix.co
Guía para agentes: workix.co/agent
Referencia de API: workix.co/api.txt

Pide a tu agente que explore Workix

Pega este prompt en Cursor, Claude u otro agente de codificación. Le pide al agente que estudie Workix y luego te ayude con tu objetivo específico.

Learn how Workix works:

1. Open https://workix.co/agent, https://workix.co/llms.txt,
   and https://workix.co/api.txt.
2. Open https://github.com/facetoplace/Workix and read README.md.
3. Explain in plain language:
   - what Workix is and who it is for;
   - how I can browse projects, roles, orders, and participants;
   - what an AI agent can do through the Workix MCP and API;
   - which parts run locally and how credentials are kept safe.
4. Look at my current project and help me choose and complete one useful next step:
   - connect Workix MCP to my agent;
   - search for relevant work, participants, or mentors by skills and interests;
   - publish or update a project, role, or participant profile;
   - deploy the Workix storefront on my own domain;
   - contribute an improvement to Workix.

Use WORKIX_API=https://workix.co for the central hub.
Do not upload freelance-platform passwords or tokens to the hub.
Adapt the instructions to my operating system, tools, and project.

¿Qué hay en este repositorio?

Este repositorio contiene los clientes abiertos e integraciones para Workix. Utilizan la API central del centro en https://workix.co, por lo que una copia local puede mostrar el catálogo compartido sin mantener un catálogo separado.

views/ contiene las páginas de la tienda.
assets/ contiene la aplicación de navegador, estilos, traducciones, archivos PWA y documentos públicos de API.
mcp/ contiene el servidor MCP de TypeScript, las herramientas de Workix y los adaptadores para plataformas de empleo compatibles.
docker/ contiene una imagen pequeña de nginx para servir la tienda.
docs/ contiene guías públicas para agentes y autoalojamiento.

Las dos partes principales son independientes:

Tienda — una interfaz web para explorar el catálogo de Workix. Puedes usarla en workix.co u hospedar la interfaz en tu propio dominio.
Servidor MCP — herramientas que permiten a un agente de IA buscar en Workix, gestionar tus publicaciones y perfil, preparar propuestas y trabajar con fuentes externas compatibles.

Los datos del catálogo son servidos por la API central de Workix. No se requieren secretos de producción para ejecutar la tienda o conectar el cliente MCP.

Usa Workix con un agente de IA

Con WORKIX_API=https://workix.co, un agente puede buscar proyectos, roles, pedidos, participantes y mentores. Con un WORKIX_AGENT_KEY, también puede crear o actualizar publicaciones y gestionar un perfil de participante.

Recomendado: instala MCP desde la fuente de este repositorio (las herramientas y adaptadores más recientes). npm/npx es opcional y puede estar desactualizado respecto a git.

Requiere Node 22.5 o superior: el almacén local es SQLite a través del node:sqlite integrado de Node, por lo que nada tiene que compilarse en el momento de la instalación.

git clone https://github.com/facetoplace/Workix.git
cd Workix/mcp
npm install
npm run build

Ejemplo de configuración de MCP en Cursor (desde la fuente):

{
  "mcpServers": {
    "workix": {
      "command": "node",
      "args": ["FULL/PATH/TO/Workix/mcp/dist/index.js"],
      "env": {
        "WORKIX_API": "https://workix.co",
        "WORKIX_AGENT_KEY": "wix_…"
      }
    }
  }
}

Atajo opcional: npx -y @workix/mcp · npm @workix/mcp · Registro Oficial co.workix/mcp · instalar interfaz: workix.co/agent

Regístrate en workix.co para obtener una clave de agente. La clave es opcional para búsquedas públicas y requerida para acciones vinculadas a tu cuenta.

Las credenciales de plataformas externas pertenecen únicamente al entorno MCP local. No envíes contraseñas ni tokens de Upwork, Kwork u otras plataformas al centro de Workix.

Consulta mcp/README.md para la instalación, las herramientas disponibles y la configuración específica de cada fuente.

Destacados de MCP 1.2.2

Los perfiles de participantes pueden registrar preferencias de networking, colaboración y mentoría (networking, startups, opensource, equity) como yes, unknown o no, además de una nota opcional.
workix_list_performers puede filtrar participantes que optaron explícitamente por formatos de networking, colaboración o mentoría; hidden: true mantiene un perfil fuera de los feeds públicos y la búsqueda.
workix_bump_profile vuelve a mostrar un perfil sin editarlo. El centro permite un bump cada tres días y devuelve un tiempo de espera con la próxima hora permitida.
El MCP también incluye el flujo de recopilación/búsqueda 1.2.0, fuentes ampliadas y adaptadores de navegador con sesión descritos en mcp/CHANGELOG.md.

Hospeda la tienda en tu dominio

Los proyectos y comunidades pueden servir la interfaz de Workix desde un dominio como work.example.com. El espejo sigue leyendo el catálogo compartido desde https://workix.co.

Despliega views/ y assets/, o usa la imagen en docker/.
Apunta la interfaz al centro:
```
<meta name="workix-api" content="https://workix.co" />
```
También puedes establecer API_BASE o WORKIX_API a https://workix.co.
Configura tu DNS y hospedaje para el dominio elegido.

Las publicaciones asociadas a ese dominio pueden destacarse para los visitantes del espejo. Consulta work.facetoplace.app para ver un ejemplo en vivo y docs/self-host.md para más detalles.

Usa otras plataformas a través de Workix MCP

Workix MCP es también una interfaz única para trabajar con mercados de freelancers y bolsas de trabajo externos. Un agente puede buscar varias fuentes en un solo resumen, abrir una publicación específica, redactar una propuesta y enviarla a través de una API disponible o preparar una lista de verificación para el navegador.

Estas integraciones se ejecutan localmente. Los tokens de API, inicios de sesión de plataformas y sesiones de navegador permanecen en tu máquina y no se envían al centro de Workix. El envío de propuestas siempre requiere confirmación humana explícita.

Preparación de la plataforma

La puntuación describe cuánto del flujo de trabajo previsto de Workix está listo hoy, no cuánto de la plataforma en sí está cubierto:

5/5 — la búsqueda y el envío funcionan a través de una API compatible.
4/5 — búsqueda confiable; el envío o la autenticación aún tienen un respaldo o limitación.
3/5 — integración útil, pero las credenciales, los proxies o una interfaz no oficial afectan la confiabilidad.
2/5 — fuente de vigilancia asistida por navegador en lugar de un feed automatizado.
1/5 — solo enlace/lista de verificación; la automatización profunda está intencionalmente fuera de alcance.

La columna Política de automatización es deliberadamente conservadora. Los términos de la plataforma y los permisos de API pueden cambiar, por lo que los usuarios también deben seguir las reglas actuales de cada fuente y su propia cuenta.

Plataforma	Búsqueda / lectura	Aplicar	Listo	Política de automatización	Dirección
Freelancehunt	API oficial	API	5/5	API y token aprobados	Mantener el flujo de trabajo completo
Freelancer.com	API oficial	Oferta por API	4/5	API y OAuth aprobados	Estabilizar la autenticación y el manejo de errores
Upwork	OAuth GraphQL	API cuando esté permitido; respaldo en navegador	4/5	Solo permisos de API aprobados; sin scraping no autorizado	Completar la configuración de OAuth y el respaldo de propuestas
FL.ru	RSS	Navegador	4/5	RSS público; la aplicación sigue bajo control humano	Mejorar categorías y análisis de presupuesto
HH.ru	API oficial	Navegador	4/5	Reglas oficiales de API y agente de usuario requerido	Mejorar filtros de proyecto/remoto; la aplicación por API es opcional
Remote OK	API pública	Sitio del empleador	4/5	Fuente pública; las reglas del empleador aplican tras la redirección	Mejorar filtros de etiquetas y tecnología
Remotive · Arbeitnow · Himalayas · Jobicy · Working Nomads · The Muse · 4 Day Week · AI Dev Jobs	API pública	Sitio del empleador	4/5	Fuentes públicas; las reglas del empleador aplican tras la redirección	Mantener como fuentes de resumen `include_jobs`
We Work Remotely · Aquent · Jobspresso	RSS público	Sitio del empleador	4/5	Fuentes públicas; las reglas del empleador aplican tras la redirección	Mantener como fuentes de resumen `include_jobs`
Tableros ATS del empleador (Greenhouse · Ashby · Lever · SmartRecruiters · Workable)	API pública por empresa	Tablero propio del empleador	4/5	Endpoints públicos de tableros de carrera; el enlace de aplicación es del empleador	Ampliar la lista de empresas en `ats-companies.json`
Trudvsem (Работа России)	API pública de datos abiertos	Externo	4/5	Datos abiertos estatales; sin acceso a cuentas	Añadir ajustes regionales; publicar requiere firma electrónica nacional y está fuera de alcance
NoFluffJobs · Landing.jobs · Get on Board	API pública	Sitio del empleador	4/5	Fuentes públicas; las reglas del empleador aplican tras la redirección	Mantener como fuentes de resumen `include_jobs`
Djinni	RSS público	Cuenta en el tablero	3/5	Fuente pública; la aplicación sigue bajo control humano	Mantener como fuente de `include_jobs`
Adzuna	API oficial con tus propias claves	Sitio del empleador	4/5	Claves de API registradas; el nivel gratuito tiene límite de tasa	Mantener como `include_jobs`; mostrar errores de cuota claramente
JobsPipe (LinkedIn · Indeed · Y Combinator · Greenhouse · Lever · Ashby · SmartRecruiters · Workday · Workable · Paylocity)	API oficial con tu propia clave	Sitio del empleador	4/5	Medido: un crédito por trabajo devuelto; tu clave, tu cuota	Excluido del resumen automático a propósito — ver más abajo
USAJOBS · Careerjet · Jooble	API oficial con tu propia clave	Externo	4/5	Claves gratuitas; cada una tiene sus propias reglas	Mantener como `include_jobs` una vez que la clave esté configurada
SuperJob	API oficial con tu propia clave	Navegador	3/5	Reglas oficiales de API	Responde 403 desde direcciones de centro de datos; necesita clave y a menudo un proxy
Reddit (r/forhire y similares)	Fuente Atom pública	Comentario o DM manual	2/5	Sin publicación automatizada ni DMs	Solo fuente; la API JSON necesita una app OAuth registrada
Dream Offer	Fuente HTTP pública	Sitio del empleador	3/5	Fuente pública; sin acceso a cuentas	Vigilar cambios en la fuente
Claw Earn · SeekClaw · Openwork	API de agente	API de agente	4/5	Tableros nativos de agentes; envío a través de su propia API	Mantener en `include_agent_gigs`; las ofertas abiertas suelen estar vacías
Superteam Earn	API de agente con tu propia clave	API de agente	4/5	Requiere `SUPERTEAM_EARN_API_KEY`	Mantener en `include_agent_gigs`
Growth.Talent · RentAHuman	API pública	API de agente o navegador	4/5	Ofertas públicas; aplicar requiere clave	Mantener en `include_agent_gigs`
Kwork	API no oficial con credenciales locales	Navegador	3/5	Acceso no oficial de alto riesgo; sin aplicación automática	Mejorar la fiabilidad del inicio de sesión y del proxy
Freelance.ru	RSS; puede necesitar proxy	Navegador	3/5	RSS público; sin evadir restricciones de cuenta	Hacer las fuentes más resistentes al bloqueo
Weblancer	RSS; puede necesitar proxy	Navegador	3/5	RSS público; sin evadir restricciones de cuenta	Hacer las fuentes más resistentes al bloqueo
Indeed	Puente JobSpy (opcional, requiere Python)	Sitio del empleador	3/5	Se ejecuta a través de tu propia instalación de `python-jobspy`, bajo sus términos y los tuyos	Mantener como puente opcional; sin scraper propio
Glassdoor · ZipRecruiter · Naukri	Puente JobSpy (opcional, requiere Python)	Sitio del empleador	1/5	Mismo puente; estos responden 403 o agotan el tiempo desde la mayoría de direcciones	Conectado pero poco fiable — depende de tu red
BDjobs	Puente JobSpy — roto aguas arriba	Sitio del empleador	1/5	Bloqueado por un error en `python-jobspy`, no por el tablero	Esperando una corrección aguas arriba; listado para que no se confunda con una mala configuración
Habr Career	JSON público del frontend, respaldo RSS	Navegador	4/5	Solo endpoints públicos; sin aplicación masiva	Incluye salario, nivel y habilidades; RSS sigue siendo el respaldo
Fiverr · SproutGigs	Vigilancia por navegador	Navegador	2/5	Briefs entrantes y ofertas manuales; sin scraper	Mantener asistido por navegador
Avito Services · YouDo	Vigilancia por navegador	Navegador	2/5	Captura manual; sin evadir reglas de cuenta	Mantener asistido por navegador
Product Radar / StartupFellows	Vigilancia por navegador o Telegram	Formulario externo o contacto	2/5	Vigilancia curada; contacto manual	Mantener como fuentes de vigilancia curada
Contra / BotPool / Wellfound	Vigilancia por navegador	Navegador	2/5	Automatización restringida o poco clara; sin scraper	Mantener asistido por navegador; sin scraper planificado
Canales de Telegram	Vigilancia por navegador/sesión de usuario	Contacto manual	2/5	Seguir las reglas del canal; sin mensajes masivos no solicitados	Mantener semimanual y configurable
LinkedIn	Lista de verificación por navegador	Manual / Easy Apply	1/5	Sin scraping automatizado ni aplicación masiva	Mantener solo semimanual
YC Co-Founder Matching / CoFoundersLab	Flujo privado por navegador	Presentación manual	1/5	Sin divulgación automatizada ni spam	Mantener como fuente de vigilancia manual
Profi.ru · Avito Работа	Perfil de navegador con sesión iniciada	Navegador (manual)	2/5	Lee tu propia fuente con sesión iniciada a través de `include_services`; sin autoaplicación; Avito además requiere `AVITO_ENABLE`	Fuente de perfil de navegador; responder/aplicar sigue siendo manual
X (Twitter)	Perfil de navegador con sesión iniciada (búsqueda en vivo)	DM/respuesta manual — sin autoaplicación	2/5	Solo opcional a través de `X_ENABLE`; la recopilación automatizada va contra los términos de X	Solo clientes potenciales (`kind: lead`); nunca se autoaplica
Comunidades de agentes (The Colony · Agent Community · Moltbook · Chirper.ai · SocialAIA · 0xWork)	Catálogo / descubrimiento	—	1/5	Networking y descubrimiento de contactos, no fuentes de empleo	Catalogado para descubrimiento y networking
Arc.dev / Magier / Feltsense	Vigilancia de emparejamiento o carreras	Manual	1/5	Solo flujo de emparejamiento/manual	Vigilancia de baja prioridad; sin integración profunda planificada

El orden de desarrollo actual es:

Estabilizar Freelancer.com y completar el flujo de OAuth/aplicación de Upwork.
Mejorar la fiabilidad de FL.ru, Freelance.ru, Weblancer y Kwork.
Añadir mejores filtros para Remote OK y HH.ru, y ampliar la lista de empresas ATS del empleador.
Mantener las plataformas cerradas y sensibles a los términos de servicio asistidas por navegador en lugar de construir scrapers frágiles.

Acerca de las fuentes medidas

Cada fuente anterior es gratuita de leer excepto JobsPipe, que cobra un crédito por cada trabajo que devuelve. Por eso es el único tablero que un resumen simple de include_jobs nunca toca — de lo contrario, un resumen programado podría gastar una cuota mensual sin que nadie lo note. Accede a él deliberadamente con la herramienta workix_jobspipe_search, nombrando platforms: ["jobspipe"], o aceptando con JOBSPIPE_IN_DIGEST=1. Un contador local rastrea lo que este MCP ha gastado y se niega a iniciar una llamada una vez que tu presupuesto mensual configurado se agota; workix_jobspipe_usage muestra lo que queda.

JobsPipe es de solo lectura. Indexa tableros de otras personas y no tiene endpoint para enviar una publicación, por lo que publicar un trabajo a través de él no es posible — una oferta llega a ese índice solo si vive en una fuente que ya rastrea.

Acerca del puente JobSpy

Indeed, Glassdoor, ZipRecruiter, Naukri y BDjobs se alcanzan a través de JobSpy (MIT), que tú instalas: pip install -U python-jobspy, Python 3.10–3.12. No ocurre nada a menos que nombres una de esas plataformas directamente — un resumen simple nunca las toca.

Lo llamamos en lugar de copiar su código a propósito. Esos tableros se leen a través de endpoints privados usando credenciales tomadas de sus propias aplicaciones móviles; mantenerlo aguas arriba significa que las credenciales viven en tu instalación en lugar de redistribuirse dentro de este paquete, y las personas que mantienen esos scrapers siguen manteniéndolos.

Ten en cuenta que solo Indeed devolvió resultados en nuestras propias pruebas. El resto están bloqueados o limitados por tasa desde la mayoría de direcciones, y BDjobs actualmente genera un error dentro del propio JobSpy. Si los demás funcionan para ti depende de tu red, y usarlos es tu decisión bajo los términos de cada tablero.

Cobertura actual: 64 plataformas en el catálogo, 36 enviadas como módulos de adaptador descargables. Más allá de las fuentes de empleo y freelance anteriores, el mismo sistema de módulos sirve al catálogo de aplicaciones dStore (publicar un sitio en vivo o PWA, encontrar aplicaciones similares) y a un lector opcional de canales de Telegram.

El catálogo de fuentes es mcp/platforms.json. Ejecuta workix_list_platforms para la lista legible por máquina y workix_sources_status para ver qué integraciones están disponibles con tu configuración local actual.

Documentación y fuentes

Contribuir — ayuda a ampliar la cobertura de empleo y canales

Workix mejora cuando la comunidad nos señala más lugares para recopilar trabajo.

Abre un Issue o PR de GitHub si conoces:

un sitio web / tablero de empleo / fuente de contratación (API pública, RSS o una lista HTML clara) que valga la pena conectar a los resúmenes MCP;
un canal o chat de Telegram donde la gente publique regularmente vacantes de TI/móvil/freelance/startup (solo @username público).

Incluso una nota breve ayuda: URL o t.me/…, qué nicho cubre y que las publicaciones son recientes. No necesitas enviar un adaptador completo — una propuesta es suficiente. Los PRs que añaden un adaptador o un canal a mcp/telegram-channels.example.json son especialmente bienvenidos.

También son bienvenidos: herramientas MCP, ajustes preestablecidos, pruebas, mejoras de tienda, documentación y traducciones.

Comienza con CONTRIBUTING.md · Catálogo de Telegram: mcp/TELEGRAM-CHANNELS.md. Preguntas sobre el producto: Soporte de Workix.

Licencia

Ver LICENSE. La modificación y redistribución requieren atribución clara. La reutilización comercial requiere un acuerdo previo.