English Français العربية

Bowmark

السجل الرسمي التجارة الإلكترونية

Do things on live websites: prices, availability, quotes, bookings, anything behind a form or login.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http bowmark 'https://api.bowmark.ai/mcp/registry' --header 'Authorization: <Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. $10 of usage a month is free.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bowmark": {
            "type": "http",
            "url": "https://api.bowmark.ai/mcp/registry",
            "headers": {
                "Authorization": "<Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. $10 of usage a month is free.>"
            }
        }
    }
}
PYPI package bowmark-mcp
Claude Code 
claude mcp add bowmark -e 'BOWMARK_API_KEY=<your bowmark_api_key>' -- uvx bowmark-mcp==2.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bowmark": {
            "command": "uvx",
            "args": [
                "bowmark-mcp==2.1.0"
            ],
            "env": {
                "BOWMARK_API_KEY": "<your bowmark_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BOWMARK_API_KEY إلزامي سري Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. $10 of usage a month is free.
NPM package @bowmark/mcp
Claude Code 
claude mcp add bowmark -e 'BOWMARK_API_KEY=<your bowmark_api_key>' -- npx -y @bowmark/mcp@2.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bowmark": {
            "command": "npx",
            "args": [
                "-y",
                "@bowmark/mcp@2.1.0"
            ],
            "env": {
                "BOWMARK_API_KEY": "<your bowmark_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BOWMARK_API_KEY إلزامي سري Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. $10 of usage a month is free.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. bowmark skill
  2. Tools
  3. OpenAI Apps (ChatGPT plugin) variant
  4. License

bowmark skill

LM Studio — GitHub strips a raw lmstudio: link, so this one is a paste, not a button. Copy it into your browser's address bar:

lmstudio://add_mcp?name=bowmark&config=eyJ1cmwiOiJodHRwczovL2FwaS5ib3dtYXJrLmFpL21jcC9iYWRnZS1sbXN0dWRpbyJ9

The skill for Bowmark — the web as callable functions. The agent reads a typed function library, writes a short script against it, and Bowmark runs it on the live sites.

npx skills add bowmark-ai/skill

Works on any host that supports the SKILL.md standard — Claude Code, Codex (which adopted the standard natively), Cursor, GitHub Copilot, OpenCode, and others.

The skill calls Bowmark's MCP server — wire that up at bowmark.ai/#install or via Smithery.

Want both in one step? On Claude Code and Codex, install the plugin instead — it bundles this skill and auto-wires the MCP:

# Claude Code
claude plugin marketplace add bowmark-ai/plugin && claude plugin install bowmark@bowmark-ai
# Codex
codex plugin marketplace add bowmark-ai/plugin   # then `codex /plugins` to install

Tools

ToolWhat it does
get_libraryRead the typed function library for a task or a site. Read-only, touches no site, and an unrecognized query returns the index rather than an error.
runExecute a short async JavaScript script against the live sites and return { ok, result, logs, error, ms }.
reportTell Bowmark what it could not do, or which run came back wrong. Recorded as feedback; retries nothing.

No MCP client? The same two calls are plain HTTP — GET https://api.bowmark.ai/v1/library?query=… and POST https://api.bowmark.ai/v1/run, both taking Authorization: Bearer $BOWMARK_API_KEY. The reference is bowmark.ai/docs/api; worked examples are at bowmark.ai/docs/scripting#no-install-at-all.

OpenAI Apps (ChatGPT plugin) variant

The ChatGPT Apps submission takes a skill as a ZIP or folder, and its needs differ slightly from the general skill: the plugin always ships the MCP alongside the skill, and ChatGPT exposes the tools under bare names. So there's a tailored variant, generated from this same canonical skill — never hand-maintained:

  • Folder: openai/bowmark/ — a content mirror of bowmark/SKILL.md with the trailing "Your API key" section and everything after it dropped (ChatGPT signs in by OAuth and cannot send a key), tool names rewritten to bare get_library / run, Claude-only frontmatter/tool-name references trimmed, and the three secret tools (list_secrets, request_secret, get_secret_link) replaced by the dashboard — the plugin's MCP is the ChatGPT directory connector, which does not offer them. That step refuses to build if the canonical wording moves out from under it. build-openai.mjs is the authority on what it cuts; this line described sections that have never existed in bowmark/SKILL.md, and a newcomer went looking for one.
  • ZIP: openai/bowmark-openai-skill.zip — the same folder zipped, ready to drop straight into the ChatGPT "Skills" uploader. A committed artifact (not built in CI: the release runner has no zip binary), so it rides the mirror to bowmark-ai/skill at a stable raw URL like any other file.

Both are generated by build-openai.mjs. Edit bowmark/SKILL.md, then regenerate and commit — never edit the openai/ copies directly (CI's check:openai fails a PR whose text mirror is stale):

pnpm -F @bowmark/skill sync:openai        # regenerate openai/bowmark/SKILL.md
pnpm -F @bowmark/skill build:openai-zip    # rebuild openai/bowmark-openai-skill.zip (commit it)

License

MIT © Bowmark AI

الأسئلة الشائعة

ما هو Bowmark؟

Do things on live websites: prices, availability, quotes, bookings, anything behind a form or login.

كيف أثبّت Bowmark؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http bowmark 'https://api.bowmark.ai/mcp/registry' --header 'Authorization: <Required. Your Bowmark API key. Sign up at https://bowmark.ai/sign-up, then create a key at https://bowmark.ai/dashboard/keys. $10 of usage a month is free.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Bowmark إلى مفتاح API؟

نعم. يتطلب BOWMARK_API_KEY, Authorization، وتضبطها في إعداداته.

هل Bowmark مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Bowmark؟

ينشره bowmark-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.