关于 workway
workway 是 WorkWay 的后端 API,负责公司与职位发现、筛选,以及从 Greenhouse、Ashby 和 YC 导入职位。分页职位接口还会返回筛选元数据和分类计数。
主要功能
- 01公司与职位发现 API
- 02可搜索和筛选的职位列表
- 03筛选分类计数
- 04导入 Greenhouse、Ashby 和 YC 数据
- 05站点地图与 feed 路由
适用场景
- 01为职位发现界面提供数据
- 02筛选并分页浏览职位
- 03从公司招聘平台加载职位
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://www.workway.dev/api/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http enigma-52-workway https://www.workway.dev/api/mcpCursor.cursor/mcp.json
{"mcpServers":{"enigma-52-workway":{"type":"http","url":"https://www.workway.dev/api/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"enigma-52-workway":{"type":"http","url":"https://www.workway.dev/api/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"enigma-52-workway":{"type":"http","url":"https://www.workway.dev/api/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"enigma-52-workway":{"serverUrl":"https://www.workway.dev/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://www.workway.dev/api/mcp需要授权工具
详细介绍
WorkWay 后端
为 WorkWay 提供支持的 API 服务,涵盖公司和职位发现、筛选器、站点地图,以及 Greenhouse/Ashby/YC 数据导入。
技术栈
- Node.js(ES modules)+ Express 5
- PostgreSQL(
pg)
目录结构
src/server.js— 应用引导、数据库初始化、路由挂载、优雅关闭src/config.js— 环境与配置映射src/routes/— API 路由处理程序src/services/— 业务逻辑src/dao/— SQL 查询和 DAO 抽象src/utils/— 日志记录器、常量、解析和分类辅助函数src/data/greenhouseCompanies.js— Greenhouse 命名空间种子列表docs/DETAILED_DOCS.md— 详细的架构和端点参考
设置
npm install
在仓库根目录创建 .env:
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
运行:
npm run dev # or: npm start
默认地址为 http://localhost:3000。
API
基础路径:/api
/api/company、/api/job、/api/feed、/api/filter、/api/cron/api/sitemap.xml、/api/sitemaps/*GET /api/job/list— 支持分页、搜索和筛选的职位列表,返回jobs、meta、applied_filters、facetsGET /api/job/filters— 筛选界面的分面计数
完整的请求/响应参考:docs/DETAILED_DOCS.md
健康检查
GET /health— 运行时长 + 时间戳GET /— 服务运行状态检查
数据导入
类 Cron 的 HTTP 端点会加载 Greenhouse、Ashby 和 YC 公司,获取其职位,对职位进行分类(领域/级别/雇佣类型),并写入 PostgreSQL;若记录已存在则更新。
生产环境
为 workway.dev 提供服务。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。