Workix MCP

Hub + MCP de busca de empregos freelance para agentes de IA (catálogo Workix e adaptadores locais).

Documentação

Workix

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

Workix é um lugar onde pessoas, projetos e trabalho se encontram.

O hub Workix reúne três coisas em um único catálogo:

Projetos — startups, produtos e comunidades em busca de pessoas.
Funções e pedidos — trabalhos abertos com descrição, orçamento, tags e uma forma de se candidatar.
Participantes — especialistas, colaboradores e mentores que podem se conectar por habilidades e interesses.

Workix não é um marketplace de freelancers tradicional. Ele não tenta substituir a relação entre um projeto e um especialista. Uma listagem leva ao contato preferido do dono do projeto ou ao formulário de inscrição, enquanto o Workix torna a oportunidade fácil de publicar, descobrir e compartilhar.

As pessoas podem navegar pelo catálogo na web. Agentes de IA podem pesquisá-lo e gerenciar listagens por meio do MCP ou da API REST. O mesmo MCP local também pode coletar oportunidades de plataformas externas, mantendo as credenciais da plataforma na máquina do usuário.

Workix aberto: workix.co
Guia para agentes: workix.co/agent
Referência da API: workix.co/api.txt

Peça ao seu agente para explorar o Workix

Cole este prompt no Cursor, Claude ou outro agente de codificação. Ele pede que o agente estude o Workix e depois ajude com seu 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.

O que há neste repositório?

Este repositório contém os clientes e integrações abertos para o Workix. Eles usam a API central do hub em https://workix.co, então uma cópia local pode exibir o catálogo compartilhado sem manter um catálogo separado.

views/ contém as páginas da loja.
assets/ contém o aplicativo de navegador, estilos, traduções, arquivos PWA e documentos públicos da API.
mcp/ contém o servidor MCP TypeScript, ferramentas do Workix e adaptadores para plataformas de trabalho suportadas.
docker/ contém uma imagem nginx pequena para servir a loja.
docs/ contém guias públicos para agentes e auto-hospedagem.

As duas partes principais são independentes:

Loja — uma interface web para navegar pelo catálogo do Workix. Você pode usá-la em workix.co ou hospedar a interface no seu próprio domínio.
Servidor MCP — ferramentas que permitem que um agente de IA pesquise no Workix, gerencie suas listagens e perfil, prepare propostas e trabalhe com fontes externas suportadas.

Os dados do catálogo são servidos pela API central do Workix. Segredos de produção não são necessários para executar a loja ou conectar o cliente MCP.

Use o Workix com um agente de IA

Com WORKIX_API=https://workix.co, um agente pode pesquisar projetos, funções, pedidos, participantes e mentores. Com um WORKIX_AGENT_KEY, ele também pode criar ou atualizar listagens e gerenciar um perfil de participante.

Recomendado: instale o MCP a partir do código-fonte deste repositório (ferramentas e adaptadores mais recentes). npm/npx é opcional e pode ficar desatualizado em relação ao git.

Requer Node 22.5 ou mais recente: o armazenamento local é SQLite através do node:sqlite integrado do Node, então nada precisa ser compilado no momento da instalação.

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

Exemplo de configuração MCP do Cursor (a partir do código-fonte):

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

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

Registre-se em workix.co para obter uma chave de agente. A chave é opcional para pesquisa pública e necessária para ações vinculadas à sua conta.

As credenciais de plataformas externas pertencem apenas ao ambiente MCP local. Não envie senhas e tokens do Upwork, Kwork ou outras plataformas para o hub Workix.

Consulte mcp/README.md para instalação, ferramentas disponíveis e configurações específicas da fonte.

Destaques do MCP 1.2.2

Perfis de participantes podem registrar preferências de networking, colaboração e mentoria (networking, startups, opensource, equity) como yes, unknown ou no, além de uma nota opcional.
workix_list_performers pode filtrar participantes que optaram explicitamente por formatos de networking, colaboração ou mentoria; hidden: true mantém um perfil fora dos feeds públicos e da pesquisa.
workix_bump_profile recoloca um perfil em destaque sem editá-lo. O hub permite um destaque a cada três dias e retorna um tempo de espera com o próximo horário permitido.
O MCP também inclui o fluxo de trabalho de coleta/pesquisa 1.2.0, fontes expandidas e adaptadores de navegador conectados descritos em mcp/CHANGELOG.md.

Hospede a loja no seu domínio

Projetos e comunidades podem servir a interface do Workix a partir de um domínio como work.example.com. O espelho ainda lê o catálogo compartilhado de https://workix.co.

Implante views/ e assets/, ou use a imagem em docker/.
Aponte a interface para o hub:
```
<meta name="workix-api" content="https://workix.co" />
```
Você também pode definir API_BASE ou WORKIX_API como https://workix.co.
Configure seu DNS e hospedagem para o domínio escolhido.

Listagens associadas a esse domínio podem ser destacadas para visitantes do espelho. Veja work.facetoplace.app para um exemplo ao vivo e docs/self-host.md para detalhes.

Use outras plataformas através do Workix MCP

O Workix MCP também é uma interface única para trabalhar com marketplaces de freelancers e quadros de empregos externos. Um agente pode pesquisar várias fontes em um único resumo, abrir uma listagem específica, redigir uma proposta e enviá-la através de uma API disponível ou preparar uma lista de verificação para o navegador.

Essas integrações são executadas localmente. Tokens de API, logins de plataforma e sessões de navegador permanecem na sua máquina e não são enviados ao hub Workix. O envio de propostas sempre requer confirmação humana explícita.

Prontidão da plataforma

A pontuação descreve quanto do fluxo de trabalho pretendido do Workix está pronto hoje, não quanto da própria plataforma está coberto:

5/5 — pesquisa e envio funcionam através de uma API suportada.
4/5 — pesquisa confiável; envio ou autenticação ainda tem uma alternativa ou limitação.
3/5 — integração útil, mas credenciais, proxies ou uma interface não oficial afetam a confiabilidade.
2/5 — fonte de monitoramento assistida por navegador em vez de um feed automatizado.
1/5 — apenas link/lista de verificação; automação profunda está intencionalmente fora do escopo.

A coluna Política de automação é deliberadamente conservadora. Os termos da plataforma e as permissões da API podem mudar, então os usuários também devem seguir as regras atuais de cada fonte e sua própria conta.

Plataforma	Busca / leitura	Candidatura	Pronto	Política de automação	Direção
Freelancehunt	API oficial	API	5/5	API e token aprovados	Manter o fluxo de trabalho completo
Freelancer.com	API oficial	Lance via API	4/5	API e OAuth aprovados	Estabilizar autenticação e tratamento de erros
Upwork	OAuth GraphQL	API quando permitido; fallback no navegador	4/5	Apenas permissões de API aprovadas; sem scraping não autorizado	Concluir configuração OAuth e fallback de propostas
FL.ru	RSS	Navegador	4/5	RSS público; candidatura permanece sob controle humano	Melhorar categorias e parsing de orçamento
HH.ru	API oficial	Navegador	4/5	Regras oficiais da API e user agent obrigatório	Melhorar filtros de projeto/remoto; candidatura via API é opcional
Remote OK	API pública	Site do empregador	4/5	Feed público; regras do empregador valem após o redirecionamento	Melhorar filtros de tags e tecnologia
Remotive · Arbeitnow · Himalayas · Jobicy · Working Nomads · The Muse · 4 Day Week · AI Dev Jobs	API pública	Site do empregador	4/5	Feeds públicos; regras do empregador valem após o redirecionamento	Manter como fontes de resumo `include_jobs`
We Work Remotely · Aquent · Jobspresso	RSS público	Site do empregador	4/5	Feeds públicos; regras do empregador valem após o redirecionamento	Manter como fontes de resumo `include_jobs`
Quadros de ATS do empregador (Greenhouse · Ashby · Lever · SmartRecruiters · Workable)	API pública por empresa	Quadro do próprio empregador	4/5	Endpoints públicos de carreiras; o link de candidatura é do empregador	Ampliar a lista de empresas em `ats-companies.json`
Trudvsem (Работа России)	API pública de dados abertos	Externo	4/5	Dados abertos do estado; sem acesso a conta	Adicionar predefinições de região; publicação exige assinatura eletrônica nacional e está fora do escopo
NoFluffJobs · Landing.jobs · Get on Board	API pública	Site do empregador	4/5	Feeds públicos; regras do empregador valem após o redirecionamento	Manter como fontes de resumo `include_jobs`
Djinni	RSS público	Conta no quadro	3/5	Feed público; candidatura permanece sob controle humano	Manter como fonte `include_jobs`
Adzuna	API oficial com suas próprias chaves	Site do empregador	4/5	Chaves de API registradas; o nível gratuito tem limite de requisições	Manter como `include_jobs`; exibir erros de cota claramente
JobsPipe (LinkedIn · Indeed · Y Combinator · Greenhouse · Lever · Ashby · SmartRecruiters · Workday · Workable · Paylocity)	API oficial com sua própria chave	Site do empregador	4/5	Medido: um crédito por vaga retornada; sua chave, sua cota	Mantido fora do resumo automático de propósito — veja abaixo
USAJOBS · Careerjet · Jooble	API oficial com sua própria chave	Externo	4/5	Chaves gratuitas; cada uma tem suas próprias regras	Manter como `include_jobs` assim que a chave for configurada
SuperJob	API oficial com sua própria chave	Navegador	3/5	Regras oficiais da API	Responde 403 para endereços de datacenter; precisa de chave e, muitas vezes, proxy
Reddit (r/forhire e similares)	Feed público Atom	Comentário manual ou DM	2/5	Sem postagem automatizada ou DMs	Apenas feed; a API JSON exige um app OAuth registrado
Dream Offer	Feed HTTP público	Site do empregador	3/5	Feed público; sem acesso a conta	Observar mudanças no feed
Claw Earn · SeekClaw · Openwork	API de agente	API de agente	4/5	Quadros nativos de agente; envio pela própria API deles	Manter em `include_agent_gigs`; listagens abertas costumam estar vazias
Superteam Earn	API de agente com sua própria chave	API de agente	4/5	Exige `SUPERTEAM_EARN_API_KEY`	Manter em `include_agent_gigs`
Growth.Talent · RentAHuman	API pública	API de agente ou navegador	4/5	Listagens públicas; candidatura exige chave	Manter em `include_agent_gigs`
Kwork	API não oficial com credenciais locais	Navegador	3/5	Acesso não oficial de alto risco; sem candidatura automática	Melhorar confiabilidade de login e proxy
Freelance.ru	RSS; proxy pode ser necessário	Navegador	3/5	RSS público; sem burlar restrições de conta	Tornar os feeds mais resilientes a bloqueios
Weblancer	RSS; proxy pode ser necessário	Navegador	3/5	RSS público; sem burlar restrições de conta	Tornar os feeds mais resilientes a bloqueios
Indeed	Ponte JobSpy (opcional, requer Python)	Site do empregador	3/5	Executa pela sua própria instalação `python-jobspy`, sob os termos dela e os seus	Manter como ponte opcional; sem scraper próprio
Glassdoor · ZipRecruiter · Naukri	Ponte JobSpy (opcional, requer Python)	Site do empregador	1/5	Mesma ponte; esses respondem 403 ou dão timeout na maioria dos endereços	Conectados, mas instáveis — depende da sua rede
BDjobs	Ponte JobSpy — quebrada upstream	Site do empregador	1/5	Bloqueada por um bug em `python-jobspy`, não pelo quadro	Aguardando correção upstream; listada para não ser confundida com má configuração
Habr Career	JSON público do frontend, fallback RSS	Navegador	4/5	Apenas endpoints públicos; sem candidatura em massa	Traz salário, nível e habilidades; RSS permanece como fallback
Fiverr · SproutGigs	Observação no navegador	Navegador	2/5	Briefs recebidos e ofertas manuais; sem scraper	Manter assistido por navegador
Avito Services · YouDo	Observação no navegador	Navegador	2/5	Captura manual; sem burlar regras de conta	Manter assistido por navegador
Product Radar / StartupFellows	Observação no navegador ou Telegram	Formulário externo ou contato	2/5	Observação curada; contato manual	Manter como fontes de observação curada
Contra / BotPool / Wellfound	Observação no navegador	Navegador	2/5	Automação restrita ou pouco clara; sem scraper	Manter assistido por navegador; sem scraper planejado
Canais do Telegram	Observação no navegador/sessão de usuário	Contato manual	2/5	Seguir regras do canal; sem mensagens em massa não solicitadas	Manter semimanual e configurável
LinkedIn	Checklist no navegador	Manual / Easy Apply	1/5	Sem scraping automatizado ou candidatura em massa	Manter apenas semimanual
YC Co-Founder Matching / CoFoundersLab	Fluxo privado no navegador	Apresentação manual	1/5	Sem divulgação automatizada ou spam	Manter como fonte de observação manual
Profi.ru · Avito Работа	Perfil de navegador logado	Navegador (manual)	2/5	Lê seu próprio feed logado via `include_services`; sem candidatura automática; Avito exige adicionalmente `AVITO_ENABLE`	Feed por perfil de navegador; resposta/candidatura permanece manual
X (Twitter)	Perfil de navegador logado (busca ao vivo)	DM/resposta manual — sem candidatura automática	2/5	Apenas com aceite via `X_ENABLE`; coleta automatizada viola os termos do X	Apenas leads (`kind: lead`); nunca se candidata automaticamente
Comunidades de agentes (The Colony · Agent Community · Moltbook · Chirper.ai · SocialAIA · 0xWork)	Catálogo / descoberta	—	1/5	Networking e descoberta de contatos, não feeds de vagas	Catalogadas para descoberta e networking
Arc.dev / Magier / Feltsense	Observação de matching ou carreiras	Manual	1/5	Apenas fluxo de matching/manual	Observação de baixa prioridade; sem integração profunda planejada

A ordem atual de desenvolvimento é:

Estabilizar o Freelancer.com e concluir o fluxo OAuth/candidatura do Upwork.
Melhorar a confiabilidade de FL.ru, Freelance.ru, Weblancer e Kwork.
Adicionar melhores filtros para Remote OK e HH.ru, e ampliar a lista de empresas ATS.
Manter plataformas fechadas e sensíveis aos termos de serviço assistidas por navegador, em vez de criar scrapers frágeis.

Sobre fontes medidas

Toda fonte acima é gratuita para leitura, exceto JobsPipe, que cobra um crédito por vaga retornada. Por isso, é o único quadro que um resumo include_jobs comum nunca toca — caso contrário, um resumo agendado poderia gastar uma cota mensal sem que ninguém percebesse. Acesse-o deliberadamente com a ferramenta workix_jobspipe_search, nomeando platforms: ["jobspipe"], ou aceitando com JOBSPIPE_IN_DIGEST=1. Um contador local rastreia o que este MCP gastou e se recusa a iniciar uma chamada quando seu orçamento mensal configurado acabar; workix_jobspipe_usage mostra o que resta.

JobsPipe é somente leitura. Ele indexa quadros de outras pessoas e não tem endpoint para envio de vagas, então publicar uma vaga por ele não é possível — uma listagem chega a esse índice apenas se já estiver em uma fonte que ele rastreia.

Sobre a ponte JobSpy

Indeed, Glassdoor, ZipRecruiter, Naukri e BDjobs são acessados via JobSpy (MIT), que você instala: pip install -U python-jobspy, Python 3.10–3.12. Nada acontece a menos que você nomeie uma dessas plataformas diretamente — um resumo comum nunca as toca.

Nós o chamamos em vez de copiar seu código de propósito. Esses quadros são lidos por endpoints privados usando credenciais obtidas dos próprios aplicativos móveis deles; manter isso upstream significa que as credenciais ficam na sua instalação, em vez de serem redistribuídas dentro deste pacote, e as pessoas que mantêm esses scrapers continuam os mantendo.

Esteja ciente de que apenas Indeed retornou resultados em nossos próprios testes. Os demais são bloqueados ou limitados por taxa na maioria dos endereços, e BDjobs atualmente gera erro dentro do próprio JobSpy. Se os outros funcionam para você depende da sua rede, e usá-los é decisão sua sob os termos de cada quadro.

Cobertura hoje: 64 plataformas no catálogo, 36 enviadas como módulos de adaptador baixáveis. Além das fontes de vagas e freelance acima, o mesmo sistema de módulos atende ao catálogo de aplicativos dStore (publicar um site ao vivo ou PWA, encontrar aplicativos semelhantes) e a um leitor opcional de canais Telegram.

O catálogo de fontes é mcp/platforms.json. Execute workix_list_platforms para a lista legível por máquina e workix_sources_status para ver quais integrações estão disponíveis com sua configuração local atual.

Documentação e feeds

Contribuindo — ajude a ampliar a cobertura de vagas e canais

O Workix melhora quando a comunidade nos aponta mais lugares para coletar trabalho.

Abra um Issue ou PR no GitHub se você conhecer:

um site / quadro de vagas / feed de contratação (API pública, RSS ou uma lista HTML clara) que valha a pena conectar aos resumos do MCP;
um canal ou chat do Telegram onde pessoas postam regularmente vagas de TI/mobile/freelance/startup (apenas @username público).

Até uma nota curta ajuda: URL ou t.me/…, qual nicho cobre e se as postagens são recentes. Você não precisa enviar um adaptador completo — uma proposta é suficiente. PRs que adicionam um adaptador ou um canal a mcp/telegram-channels.example.json são especialmente bem-vindos.

Também são bem-vindos: ferramentas MCP, predefinições, testes, melhorias na loja, documentação e traduções.

Comece com CONTRIBUTING.md · Catálogo do Telegram: mcp/TELEGRAM-CHANNELS.md. Dúvidas sobre o produto: Suporte do Workix.

Licença

Veja LICENSE. Modificação e redistribuição exigem atribuição clara. Reuso comercial exige acordo prévio.