Ruyuejian Jobs MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Ruyuejian Jobs MCP
Search China tech jobs from companies' official career pages, directly inside Claude, Cursor, or another MCP client. Every result preserves its official source URL when available, source publication time, and first-seen time.
Data is collected from public official career pages and refreshed daily, not in real time. Delisted jobs are removed by source-reachability checks and the existing delisting pipeline. No API key is required; the server is read-only.
30-second example
User: 帮我找北京最近三天发布的 AI 产品经理岗位,给出官网链接。
The client should call:
{
"query": "AI 产品经理",
"city": "北京",
"postedWithinDays": 3,
"limit": 20,
"offset": 0
}The response contains active matching jobs with source.officialUrl, source.publishedAt, and source.firstSeenAt. If dateFilter.coverage is partial, the agent must say the scan was incomplete rather than claiming these are all matching jobs.
Related MCP server: SinoJobs Scout MCP
Clients
Claude Desktop / Cursor / generic mcpServers
{
"mcpServers": {
"ruyuejian-jobs": {
"command": "npx",
"args": ["-y", "ruyuejian-jobs-mcp"]
}
}
}Claude Code
claude mcp add ruyuejian-jobs -- npx -y ruyuejian-jobs-mcpNode.js 20 or newer is required. For a local checkout, build with npm run build, then use node /absolute/path/to/mcp/dist/index.js as the command instead.
Tools
Tool | Purpose | Important inputs |
| Search active postings with provenance |
|
| Read one active posting by UUID |
|
| List companies and active-job counts |
|
| Read campus phases, dates, source links and confidence | none |
Use short title keywords such as AI 产品经理, not a full natural-language sentence. City values are normal names such as 北京, not URL slugs.
Data contract v1
The durable contract is the versioned JSON returned by the tools; MCP is only its transport. Every response has:
contractVersion: currently1.0.0.status:ok,no_results, orerror.data: tool-specific structured data, ornullon failure.meta: retrieval time,company_official_career_pages, anddailyrefresh semantics.reason: structured empty-result semantics when applicable.error: stable code, message, and retryability on failure.agentInstructions: constraints the consuming agent must preserve in its answer.
Provenance and time
source.officialUrlis an HTTP(S) official-career-page link, ornull. Agents must never invent a replacement URL.source.publishedAtis the publication time supplied by the official source, ornull.source.firstSeenAtis when Ruyuejian first observed the job; it is not represented as the official publication time.urlDowngradedToListing=truemeans the source leads to an official listing page rather than a reliable job-detail page.Detail
salaryMin/salaryMaxfollow the website's monthly-K convention: values at least 1000 are divided by 1000 for K/month; smaller values are already K/month. Agents must not silently convert them to annual salary.
Empty results and anti-fabrication
no_results is a successful, authoritative tool outcome—not an invitation to fill gaps from model memory. Stable reason codes include NO_MATCHING_JOBS, NO_JOBS_IN_DATE_RANGE, JOB_NOT_FOUND_OR_DELISTED, NO_MATCHING_COMPANIES, and NO_CAMPUS_TIMELINE_DATA.
Date-window completeness
The existing public API has no server-side relative-date filter. postedWithinDays therefore uses a rolling N * 24h window and scans at most 100 upstream records, newest first:
complete: the scan reached all candidates or records older than the window.partial: more recent candidates may exist beyond the scanned set.matchedInScannedSetis not a global total.Records with no usable date are excluded and counted as
excludedUnknownDate.Date-filtered searches do not support offset pagination; the input schema rejects that combination.
Errors and local budgets
Upstream timeout, HTTP 429/5xx, invalid responses, and local rate limiting return status=error with no fabricated fallback data. The package limits itself to 30 upstream requests per rolling minute, 50 jobs per normal page, 100 records per date scan, and a 10-second upstream timeout.
RUYUEJIAN_API_BASE_URL can point to another HTTP(S) API base for development. It defaults to https://ruyuejian.com/api.
Measurement and live eval
Set RUYUEJIAN_MCP_TELEMETRY=1 to emit one structured JSON event per tool call to stderr. Events contain tool name, status, reason/error code, result counts, date coverage and duration; they deliberately exclude raw queries, job IDs, descriptions and source URLs. This is local, opt-in telemetry—nothing is transmitted to Ruyuejian by the package.
Run npm run eval:live after each schema or mapping change. It performs read-only production calls through a real MCP client and asserts search, detail, companies, recent-date coverage and campus-timeline contracts.
Development
npm install
npm run build
npm testThe eval suite covers source citation, recent-date filtering, partial coverage, empty results, delisting, upstream failures, invalid parameters, and real MCP client/server calls over an in-memory transport.
Maintainers: see PUBLISHING.md for npm, Official Registry, directory submission, production rollout and community-post steps.
中文说明
如约见岗位数据全部来自公司官方招聘页,由 Scrapy + Playwright 采集,并非第三方岗位聚合。每条结果尽可能保留官网原始链接、官网发布时间与首次收录时间;数据按日刷新,不得宣称实时。空结果、部分日期覆盖和上游故障都有独立机器可读状态,Agent 不得编造岗位、日期或链接。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
中国校园招聘(秋招/春招/实习/提前批)在招岗位、企业档案、投递截止与求职攻略数据。免 API Key、免注册、只读。
Chinese company registry, litigation, IP and credit data for AI agents. Read-only remote MCP server.
Live job postings from employer career sites: company roles, title search, remote jobs. Read-only.
Free read-only Chinese AI news MCP: verified events, reports, products. No API key.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides MCP tools for job discovery, welfare filtering, resume and AI-assisted applications, and recruiter workflows across Chinese job platforms such as BOSS Zhipin, Zhilian, and 51job.MIT
- AlicenseNot gradedqualityCmaintenanceEnables any MCP host to search job postings on sinojobs.com and retrieve individual job details via read-only search and lookup tools, with keyword, location, remote-only, and posting-date filters. Works over stdio with polite rate limiting and returns normalized results including title, company, location, apply URL, and publish date.MIT
- AlicenseNot gradedqualityCmaintenanceEnables any MCP host to search topstartups.io job postings by keyword, location, remote preference, and date, and to fetch individual job details through read-only tools.MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP hosts to search and retrieve job listings from nowcoder.com through public API/RSS, with keyword, location, remote, date, and limit filters plus read-only job detail lookup.MIT