Metadata-Version: 2.5
Name: jobvision-mcp
Version: 0.1.0
Summary: Unofficial read-only MCP server for Jobvision (jobvision.ir), the Iranian job portal: job search, ads, companies, advertised pay.
Project-URL: Homepage, https://github.com/sepehr071/jobvision-mcp
Project-URL: Issues, https://github.com/sepehr071/jobvision-mcp/issues
Project-URL: Website, https://mcpfarsi.ir/
Author-email: Sepehr Radmard <sepehrr80@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: careers,claude,iran,job-search,jobs,jobvision,jobvision-ir,mcp,model-context-protocol,persian,recruitment,salary,tehran
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: curl-cffi>=0.16.3
Requires-Dist: httpx-curl-cffi>=0.1.5
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<3,>=2.2
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.sepehr071/jobvision-mcp -->

<div align="center">

# jobvision-mcp: Jobvision (جاب‌ویژن) Iran jobs MCP server for AI agents

**jobvision-mcp is an unofficial, read-only MCP server that gives AI agents the job ads of Jobvision (jobvision.ir), the largest Iranian job portal.**<br>
Its 14 tools search job ads with real filters, read a full ad, find similar ads, find companies by name and read their profile, rating and interview reports,<br>
estimate pay from advertised salaries and from Jobvision's career-guide salary survey, count open ads per category or province, and list public-sector hiring news.<br>
No API key or Jobvision account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

[![PyPI](https://img.shields.io/pypi/v/jobvision-mcp?color=2563eb)](https://pypi.org/project/jobvision-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/jobvision-mcp)](https://pypi.org/project/jobvision-mcp/)
[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/jobvision-mcp/blob/main/LICENSE)

[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [Tools](#tools) · [FAQ](#faq) · [فارسی](#فارسی)

</div>

---

## For AI agents

- **What:** unofficial MCP server (model context protocol) for jobvision.ir: job search with filters (city, category, work type, seniority, experience, remote, internship, military service, posted within, minimum advertised pay), full job ads, similar ads, company profiles with open ads, advertised-pay statistics and lookup lists.
- **Install:** `uvx jobvision-mcp` or `claude mcp add jobvision -- uvx jobvision-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
- **Auth:** none, no API key or account. Optional `JOBVISION_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
- **Access:** read-only. It cannot log in, apply, save jobs or post ads, so no confirmation is needed before calling any tool.
- **Tools:** 14, all prefixed `jv_`. Typical sequences: `jv_search` -> `jv_job` -> `jv_company`; `jv_companies` -> `jv_interviews`; `jv_careers` -> `jv_career` for salary levels; `jv_pay_stats` for "how much does X earn"; `jv_locations` / `jv_options` when a city, category or industry needs a slug or id.
- **Use when:** the user wants jobs in Iran (استخدام), wants to compare employers or cities, or wants to know what a role pays in ads.
- **Do not use when:** the user needs Jobvision's salary calculator or employee company reviews (account only; interview reports are covered), or jobs outside Iran.
- **Output:** compact JSON. Pay is the advertised monthly range in million Toman (most ads hide it). Dates are ISO UTC. Texts are Persian or English as employers wrote them.
- **Machine-readable:** [`server.json`](https://github.com/sepehr071/jobvision-mcp/blob/main/server.json).

## Quick start

```bash
claude mcp add jobvision -- uvx jobvision-mcp
```

Any MCP client: command `uvx`, args `["jobvision-mcp"]`. Behind a proxy set `JOBVISION_MCP_PROXY=http://host:port`.

## Tools

| Tool | Use it to |
|---|---|
| `jv_search` | Search ads by keyword with filters; sort by newest, relevance or advertised pay; paged |
| `jv_job` | Read one ad: description, required software, conditions, benefits, pay, location, dates, employer |
| `jv_similar_jobs` | Ads Jobvision considers similar to one ad |
| `jv_company` | Employer profile (size, industries, founded, website, benefits) and its open ads |
| `jv_pay_stats` | Median, quartiles and extremes of the pay that matching ads advertise (samples up to 300 ads) |
| `jv_suggest` | Job-title autocomplete with how often titles occur |
| `jv_locations` | Province, city and Tehran-area names with the slugs the city filter takes |
| `jv_options` | Categories, industries, benefits, salary ranges and other filter lists |
| `jv_companies` | Company directory: search by name, filter by province, industry, size, rating band, hiring; ranked by Jobvision score |
| `jv_interviews` | A company's interview reports: score, difficulty, typical duration, common steps, individual reports or questions asked |
| `jv_careers` | ~100 career-guide job titles ranked by satisfaction, median salary or open ads |
| `jv_career` | One job title: salary distribution (by city group), ad growth, duties, skills, how to enter, related careers |
| `jv_market` | Open-ad counts split by category, province, work type, seniority, experience, pay band or age |
| `jv_government_news` | Recruitment announcements for banks, ministries, oil and gas and other public sectors; read one in full |

Example: "python jobs in Isfahan that pay at least 40 million" -> `jv_search(keyword="python", city="اصفهان", salary_min=40, sort="salary")`.

## FAQ

**Is this official?** No. It reads the public JSON that jobvision.ir's own website uses. Requests are cached briefly and spaced out.

**Does it show salaries?** Only what ads advertise (about one in five ads shows a range). `jv_pay_stats` says how many ads it based its numbers on.

**Where do real salaries come from?** `jv_career` and `jv_careers` use Jobvision's own career-guide survey (median pay per job title, optionally per city group), which covers jobs whose ads hide pay.

**Can it apply to jobs?** No, it is read-only.

## فارسی

`jobvision-mcp` یک سرور MCP غیررسمی و فقط‌خواندنی برای جاب‌ویژن (jobvision.ir) است: جستجوی آگهی‌های استخدام با فیلتر (شهر، گروه شغلی، نوع همکاری، سطح ارشدیت، سابقه، دورکاری، کارآموزی، امریه، حداقل حقوق)، متن کامل آگهی، آگهی‌های مشابه، پروفایل شرکت و آگهی‌های باز آن و آمار حقوق اعلام‌شده در آگهی‌ها. به کلید API یا حساب کاربری نیاز ندارد.

نصب: `uvx jobvision-mcp`

---

Unofficial project, not affiliated with Jobvision. MIT license. Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071.
