JsonLink
Web access for AI agents: URL to Markdown, link metadata, screenshots, links and images of any URL.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
jsonlink-mcpclaude mcp add jsonlink -e 'JSONLINK_API_KEY=<your jsonlink_api_key>' -- npx -y jsonlink-mcp@0.2.0
{
"mcpServers": {
"jsonlink": {
"command": "npx",
"args": [
"-y",
"jsonlink-mcp@0.2.0"
],
"env": {
"JSONLINK_API_KEY": "<your jsonlink_api_key>"
}
}
}
}
متغيرات البيئة
JSONLINK_API_KEYإلزامي سري Your JsonLink API key (free at https://jsonlink.io/signup)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
JsonLink MCP Server
Give your AI agent the web. The JsonLink MCP server lets Claude, Cursor, VS Code and any MCP client read web pages as Markdown, get link metadata, take screenshots and list the links and images on any URL.
- Reads JavaScript-heavy pages — pages are loaded in a real browser when needed.
- Gets past blocks — requests are retried through a proxy when a site blocks them.
- Failed requests are free — timeouts and pages that can't load cost no credits.
Tools
| Tool | What it does | Credits |
|---|---|---|
url_to_markdown | Main content of a page as clean Markdown, for reading articles, docs and blog posts | 1 |
extract_metadata | Title, description, preview images, favicon and site name of a URL | 1 |
screenshot | Screenshot of a page (desktop, mobile, tablet, full page or one element), returned as an image. Ads, trackers, chat widgets and cookie banners hidden; optional dark mode | 2 |
extract_links | Every link on a page with anchor text, follow/nofollow and internal/external | 1 |
extract_images | Every image on a page with format, dimensions and file size | 1 |
Get an API key
Create a free account — the free plan includes 100 credits every month, no credit card. Copy your key from the dashboard.
Setup
Replace YOUR_API_KEY with your JsonLink key.
Claude Code
claude mcp add jsonlink -e JSONLINK_API_KEY=YOUR_API_KEY -- npx -y jsonlink-mcp
Claude Desktop
Add this to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"jsonlink": {
"command": "npx",
"args": ["-y", "jsonlink-mcp"],
"env": { "JSONLINK_API_KEY": "YOUR_API_KEY" }
}
}
}
Cursor
Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"jsonlink": {
"command": "npx",
"args": ["-y", "jsonlink-mcp"],
"env": { "JSONLINK_API_KEY": "YOUR_API_KEY" }
}
}
}
VS Code
Add this to .vscode/mcp.json:
{
"servers": {
"jsonlink": {
"command": "npx",
"args": ["-y", "jsonlink-mcp"],
"env": { "JSONLINK_API_KEY": "YOUR_API_KEY" }
}
}
}
Windsurf and other clients
Any client that runs stdio MCP servers works the same way: command npx, arguments -y jsonlink-mcp, environment variable JSONLINK_API_KEY.
Example prompts
- "Read https://example.com/blog/post and summarize it in five bullet points."
- "Take a mobile screenshot of my landing page and tell me what looks broken."
- "Screenshot just the pricing section of stripe.com in dark mode."
- "Get the title and description of these 10 links and make a table."
- "List the external links on this page that are nofollow."
Configuration
| Variable | Description |
|---|---|
JSONLINK_API_KEY | Your JsonLink API key (required). |
JSONLINK_API_URL | API base URL. Defaults to https://jsonlink.io. |
Pricing
Every tool call uses credits from your JsonLink plan: 1 credit per page, 2 per screenshot. Plans start at $15/month for 50,000 credits — see pricing. Credits and rate limits are the same as the REST API.
Development
npm install
npm run build
JSONLINK_API_KEY=YOUR_API_KEY node dist/index.js
Run it as a remote (Streamable HTTP) server with node dist/index.js --http --port 3100; clients send their key as Authorization: Bearer YOUR_API_KEY.
License
MIT
الأسئلة الشائعة
ما هو JsonLink؟
Web access for AI agents: URL to Markdown, link metadata, screenshots, links and images of any URL.
كيف أثبّت JsonLink؟
يعمل على جهازك. في Claude Code: claude mcp add jsonlink -e 'JSONLINK_API_KEY=<your jsonlink_api_key>' -- npx -y jsonlink-mcp@0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج JsonLink إلى مفتاح API؟
نعم. يتطلب JSONLINK_API_KEY، وتضبطها في إعداداته.
هل JsonLink مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون JsonLink؟
ينشره mauriblint. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.