Ponisha Freelance

io.github.sepehr071由 GitHub 账号 sepehr071 发布v0.2.0更新于 Nov 7, 2026

Read-only Ponisha (ponisha.ir) freelance market: projects, bids, freelancers, skill demand.

发布方自己的服务：freelance.link

已验证STDIO仅桌面网页搜索与抓取商业与电商

服务详情

标识符: io.github.sepehr071/ponisha-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Nov 1, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 sepehr071。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.sepehr071%2Fponisha-mcp.svg)](https://sourceweft.com/mcp/io.github.sepehr071%2Fponisha-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

面向 Ponisha（ponisha.ir）自由职业市场的非官方只读 MCP 服务器，可让助手搜索项目、投标、自由职业者与技能需求。

可以做什么: 搜索并查看项目：按关键词、技能、分类、预算筛选和排序，查看单个项目的预算、截止时间与雇主履历
读取项目上的报价：价格、交付天数、自荐说明、投标者等级与评分
搜索自由职业者，查看公开资料、评价与作品集
浏览技能与分类，查询固定价格服务套餐及其详情
汇总某项技能的市场需求、预算分位、竞争程度与发布趋势
列出雇主或自由职业者的已完成与进行中项目
适用场景: 适合需要了解伊朗自由职业市场时使用：寻找可投标的项目、某类工作的报酬水平、项目竞争激烈程度、雇主是否可靠，或为某项技能挑选人选。不适用于投标、发消息或发布项目，也不提供私人联系方式。
运行要求: 通过 uvx 以 stdio 在本地运行，需要 uv 与 Python 3.10 或更高版本。无需 API 密钥或 Ponisha 账号。可选环境变量 PONISHA_MCP_PROXY 用于设置 HTTP 代理地址或逗号分隔的多个地址，系统代理设置会被忽略。需要能访问 ponisha.ir 的网络。

安装前请注意

只读：无法登录、投标、发布项目或发送消息。它读取的是网站匿名访客所用的同一公开 API，属非官方实现，接口变动可能导致失效。内容为波斯语的公开用户内容，金额以托曼计，时间为德黑兰时间。报价列表可能较慢，投标数多的项目最长约需 30 秒。

安装

在 SourceWeft 中

打开控制台中的 Ponisha Freelance，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

ponisha-mcp: Ponisha (پونیشا) freelance marketplace MCP server for AI agents

ponisha-mcp is an unofficial, read-only MCP server that gives AI agents the public data of Ponisha (ponisha.ir), Iran's freelance marketplace.
Its 14 tools search projects (text, skills, category, budget, sort), show a project with the employer's track record, list the offers made on it, search freelancers, read profiles, reviews and portfolios, browse fixed-price service packages, and summarize demand, budgets and trends for a skill.
No API key or Ponisha account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

For AI agents · Quick start · Tools · FAQ · فارسی

For AI agents

What: unofficial MCP server (model context protocol) for ponisha.ir: project search, project details, bids, freelancer search, public profiles, skills and categories, skill market summary.
Install: uvx ponisha-mcp or claude mcp add ponisha -- uvx ponisha-mcp. Transport: stdio. Needs uv (Python 3.10+).
Auth: none. Optional PONISHA_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
Access: read-only. It cannot log in, bid, post projects or message anyone, so no confirmation is needed before calling any tool.
Tools: 14, all prefixed pn_. Typical sequences: pn_skills -> pn_search_projects -> pn_project -> pn_bids; pn_search_freelancers -> pn_profile; pn_skills -> pn_market / pn_trend; pn_profile -> pn_reviews + pn_portfolios; pn_services -> pn_service.
Use when: the user wants freelance projects to bid on in Iran, what a kind of work pays, how crowded a project is, whether an employer is reliable, or who to hire for a skill.
Do not use when: the user wants to apply, message or post (read-only), or needs private contact data.
Output: compact JSON. Money is Toman. Times are Tehran time. Text is Persian user content.

Quick start

Any MCP client: command uvx, args ["ponisha-mcp"].

Tools

Tool	What it does
`pn_search_projects`	Projects by text, skills, category, open/all, budget range, sort.
`pn_project`	One project: brief, budget, deadline, employer track record, optional bid price sample.
`pn_bids`	Offers on a project: price, days, pitch, bidder level and rating (paged).
`pn_search_freelancers`	Freelancers by text, skills, level, portfolio, ranked by score.
`pn_profile`	Public profile of a freelancer or employer.
`pn_skills`	Skill name -> slug/id (about 700 skills).
`pn_categories`	Top-level categories, or the sub-categories of one.
`pn_market`	Open projects, budget quartiles, competition and related skills for one skill.
`pn_trend`	Posting rate, median budget and bids for a skill sampled across its whole history.
`pn_reviews`	Reviews of a user with score breakdown, or recent reviews for a skill.
`pn_portfolios`	Search about 500k portfolio items, or list one user's.
`pn_services`	Fixed-price service packages by category, price, rating.
`pn_service`	One package: deliverables, requirements, paid add-ons.
`pn_user_projects`	An employer's or freelancer's finished/open projects.

FAQ

Is it official? No. It reads the same public API the ponisha.ir web app uses for anonymous visitors.

Why are bids slow? Ponisha serves the bids list slowly (seconds, up to 30 s on projects with 100+ bids). Keep limit small.

Why does the budget filter only look at one page? The site has no budget filter. The tool scans up to 50 projects per page and keeps those whose range fits.

فارسی

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

مبلغ‌ها به تومان و زمان‌ها به وقت تهران (میلادی) هستند. این ابزار ثبت پیشنهاد، پیام یا ثبت پروژه انجام نمی‌دهد.

Author: Sepehr Radmard (سپهر رادمرد) · github.com/sepehr071 · linkedin.com/in/sepehr-radmard

来源：README.md，提交 b822f8a