English Français العربية

io.github.Enigma-52/workway

السجل الرسمي البحث والويب

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>'
إعداد 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>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.Enigma-52/workway؟

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

كيف أثبّت io.github.Enigma-52/workway؟

يعمل كخادم بعيد. في 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>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Enigma-52/workway إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.Enigma-52/workway مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.Enigma-52/workway؟

ينشره Enigma-52. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.