Veilus
Drive Veilus browser profiles from an AI assistant: profiles, pages, scripts, schedules.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
veilus-mcpclaude mcp add veilus -e 'VEILUS_API_TOKEN=<your veilus_api_token>' -e 'VEILUS_BINARY=<VEILUS_BINARY>' -- npx -y veilus-mcp@0.1.0
{
"mcpServers": {
"veilus": {
"command": "npx",
"args": [
"-y",
"veilus-mcp@0.1.0"
],
"env": {
"VEILUS_API_TOKEN": "<your veilus_api_token>",
"VEILUS_BINARY": "<VEILUS_BINARY>"
}
}
}
}
متغيرات البيئة
VEILUS_API_TOKENإلزامي سري API token from the API & MCP page of the Veilus appVEILUS_BINARYPath to the Veilus app binary, if not in the default macOS location
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Veilus SDK
Launch Veilus browser profiles from your own code and drive them with Playwright.
Works with
Tested with a real Veilus profile — see examples/TESTED.md for versions and date: Playwright · Puppeteer · browser-use · Stagehand · Crawl4AI · LangChain · Scrapling · Crawlee · playwright-mcp · agent-browser
Ready-made solutions: solutions/ — price monitor, geo landing check, AI agent over MCP.
| Language | Package | Install |
|---|---|---|
| Node.js | veilus | npm install veilus playwright-core |
| Python | veilus | pip install "veilus[playwright]" |
| MCP | veilus-mcp | npx -y veilus-mcp (launcher for the app's MCP server) |
Both are thin clients of the Veilus desktop app's local REST API: they launch a profile, then attach Playwright to that profile's own browser over its CDP address, so your script runs with the profile's fingerprint, proxy and cookies. They need the app (0.2.9 or newer) running with the local API on, and a token in VEILUS_API_TOKEN.
For other tools (Puppeteer, playwright-mcp, browser-use, Crawl4AI…), see Use a Profile from Other Tools. The full REST API is documented at docs.veilus.io.
Also in the docs: Web scraping recipe · Common issues · FAQ.
License
MIT or Apache-2.0, at your option.
الأسئلة الشائعة
ما هو Veilus؟
Drive Veilus browser profiles from an AI assistant: profiles, pages, scripts, schedules.
كيف أثبّت Veilus؟
يعمل على جهازك. في Claude Code: claude mcp add veilus -e 'VEILUS_API_TOKEN=<your veilus_api_token>' -e 'VEILUS_BINARY=<VEILUS_BINARY>' -- npx -y veilus-mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Veilus إلى مفتاح API؟
نعم. يتطلب VEILUS_API_TOKEN، وتضبطها في إعداداته.
هل Veilus مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Veilus؟
ينشره veilus. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.