io.github.Enigma-52/workway

Registre officiel Recherche et web

Search 490k+ live jobs from company ATS boards, save roles, follow companies, manage talent profile.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code
claude mcp add --transport http workway 'https://www.workway.dev/api/mcp' --header 'Authorization: <Bearer <workway-api-key>. Generate a key at https://workway.dev/dashboard/seeker/api-keys>'
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "workway": {
            "type": "http",
            "url": "https://www.workway.dev/api/mcp",
            "headers": {
                "Authorization": "<Bearer <workway-api-key>. Generate a key at https://workway.dev/dashboard/seeker/api-keys>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. WorkWay Backend
  2. Stack
  3. Structure
  4. Setup
  5. API
  6. Health
  7. Ingestion
  8. Production

WorkWay Backend

API service powering WorkWay — company/job discovery, filters, sitemaps, and Greenhouse/Ashby/YC ingestion.

Stack

  • Node.js (ES modules) + Express 5
  • PostgreSQL (pg)

Structure

  • src/server.js — app bootstrap, DB init, route mount, graceful shutdown
  • src/config.js — environment/config mapping
  • src/routes/ — API route handlers
  • src/services/ — business logic
  • src/dao/ — SQL queries and DAO abstractions
  • src/utils/ — logger, constants, parsing/classification helpers
  • src/data/greenhouseCompanies.js — seed list of Greenhouse namespaces
  • docs/DETAILED_DOCS.md — detailed architecture and endpoint reference

Setup

npm install

Create .env in repo root:

APP_ENV=dev
POSTGRES_DB_HOST=localhost
POSTGRES_DB_PORT=5432
POSTGRES_DB_USER=postgres
POSTGRES_DB_PASSWORD=root
POSTGRES_DB_DATABASE=eqhqdb
POSTGRES_DB_MAX_CONNECTIONS=20
PORT=3000

Run:

npm run dev   # or: npm start

Defaults to http://localhost:3000.

API

Base path: /api

  • /api/company, /api/job, /api/feed, /api/filter, /api/cron
  • /api/sitemap.xml, /api/sitemaps/*
  • GET /api/job/list — paginated job listing with search/filters, returns jobs, meta, applied_filters, facets
  • GET /api/job/filters — facet counts for the filter UI

Full request/response reference: docs/DETAILED_DOCS.md

Health

  • GET /health — uptime + timestamp
  • GET / — server-running check

Ingestion

Cron-style HTTP endpoints load Greenhouse, Ashby, and YC companies, fetch their jobs, classify them (domain/level/employment type), and upsert into PostgreSQL.

Production

Serves workway.dev.

Questions fréquentes

Qu'est-ce que io.github.Enigma-52/workway ?

Search 490k+ live jobs from company ATS boards, save roles, follow companies, manage talent profile.

Comment installer io.github.Enigma-52/workway ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http workway 'https://www.workway.dev/api/mcp' --header 'Authorization: <Bearer <workway-api-key>. Generate a key at https://workway.dev/dashboard/seeker/api-keys>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Enigma-52/workway ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

io.github.Enigma-52/workway est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.Enigma-52/workway ?

Il est publié par Enigma-52. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.