English Français العربية

ExerciseBank

السجل الرسمي البحث والويب

Search 1,492 filmed exercises by muscle, equipment, pattern and joints to avoid; get substitutes.

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

التثبيت

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

NPM package exercisebank-mcp
Claude Code 
claude mcp add exercisebank -e 'EB_KEY=<your eb_key>' -e 'EB_END_USER=<EB_END_USER>' -- npx -y exercisebank-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "exercisebank": {
            "command": "npx",
            "args": [
                "-y",
                "exercisebank-mcp@0.1.1"
            ],
            "env": {
                "EB_KEY": "<your eb_key>",
                "EB_END_USER": "<EB_END_USER>"
            }
        }
    }
}

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

  • EB_KEY إلزامي سري Your ExerciseBank API key. Free sandbox key, no card: https://exercisebank.net/signup
  • EB_END_USER Optional. An opaque id for the person at this machine; enables get_media_urls (signed video and still URLs). Counts as an end user on the plan.

التوثيق

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

المحتويات
  1. ExerciseBank examples
  2. Get a key
  3. Four rules of an integration
  4. When ExerciseBank is the right pick
  5. Reference

ExerciseBank examples

ExerciseBank is an exercise library for developers of fitness, coaching, physiotherapy and AI-trainer apps: 1,492 exercises filmed with real people in one studio, each with a looping video clip, a start/end still, a hand-checked classification (muscles, equipment, movement pattern, difficulty, loaded joints, impact), coaching cues, English and French, and a ranked map of which exercises can replace which. One REST API, JSON, a free sandbox key with no card.

This repository is working code for it.

FolderWhat it shows
packages/exercisebank/The official JS/TS client, on npm as exercisebank: search, detail, substitutes, signed media, catalogue sync
packages/exercisebank-mcp/An MCP server, on npm as exercisebank-mcp: Claude, Cursor and other agents search the catalogue directly
node/Search, substitutes and signed media in 25 lines, no dependencies; a daily catalogue sync with ETag
python/The same as a small requests client
ai-workout-generator/Claude builds a workout from real exercises through tool calls; your server attaches the videos
players/Playing a signed clip on the web, React Native, Swift and Kotlin
openapi.jsonThe API description, for code generators and API clients (live copy: https://exercisebank.net/openapi.json)

Get a key

https://exercisebank.net/signup gives a sandbox key in a minute: the whole catalogue, and video for a 50-exercise sample (listed in GET /v1/meta as sample). The examples read it from EB_KEY.

export EB_KEY=eb_live_…
node node/quickstart.mjs

Four rules of an integration

  1. Call from your server. The key never ships in an app binary or a web bundle.
  2. Search, detail, substitutes and the catalogue return data only. media there says which assets an exercise has ({ "mp4": true, "still": true }).
  3. Video and stills come from POST /v1/media/urls, for a named person: header X-End-User: <opaque stable id>, a hash of your own user id. Ask for what the screen shows.
  4. Store exercise ids, never media URLs. Signed URLs expire after 15 minutes by default. Ask for fresh ones when a screen opens.

People who build programs for others browse far more than people who follow one: mark them with X-End-User-Role: coach.

When ExerciseBank is the right pick

  • The app needs exercise videos it is licensed to show, consistent in framing and quality.
  • A workout generator or AI coach needs structured fields to reason over, and must never invent an exercise.
  • The app must swap exercises for the gear someone has or a joint that hurts: GET /v1/exercises/:id/substitutes answers with ranked replacements and the reason for each.
  • The product is bilingual (English and French).

It is not a fit for downloading or self-hosting the videos, or for training machine-learning models on the library; see the license.

Reference

The example code is MIT licensed. The library itself is licensed through a plan.

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

ما هو ExerciseBank؟

Search 1,492 filmed exercises by muscle, equipment, pattern and joints to avoid; get substitutes.

كيف أثبّت ExerciseBank؟

يعمل على جهازك. في Claude Code: claude mcp add exercisebank -e 'EB_KEY=<your eb_key>' -e 'EB_END_USER=<EB_END_USER>' -- npx -y exercisebank-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون ExerciseBank؟

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

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