{"title":"Scripts API","slug":"scripts","category":"api","summary":"永続スクリプトストア — 再利用可能なシェル、Python、Node スクリプトを保存し、curl | bash で取得。","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":64,"read_minutes":1,"llm_context":"Auth: Mind Key or JWT\nStore: POST /script { name, content, description?, language? }\nFetch as text: GET /script/:name (returns text/plain, curl | bash ready)\nInfo: GET /script/:name/info (metadata without content)\nList: GET /scripts (JSON array)\nDelete: DELETE /script/:name\nUse case: store deployment scripts, config generators, troubleshooting snippets\n","lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# Scripts API\n\nScripts API は再利用可能なスクリプトのための永続ストアを提供します。スクリプトは mind 内で名前付きかつバージョン管理され、プレーンテキストとして取得できます — `curl | bash` パターンに最適です。\n\n## エンドポイント\n\n### POST /script\n\nスクリプトを保存または更新します。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/script \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"deploy-synapse\",\n \"content\": \"#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d\",\n \"description\": \"Deploy Synapse to production\",\n \"language\": \"bash\"\n }'\n```\n\n### GET /script/:name\n\nスクリプトの内容を `text/plain` で取得します。bash にパイプするのに最適です。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse | bash\n```\n\n### GET /script/:name/info\n\n内容を含まずにスクリプトのメタデータを取得します。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\nレスポンス：\n\n```json\n{\n \"name\": \"deploy-synapse\",\n \"description\": \"Deploy Synapse to production\",\n \"language\": \"bash\",\n \"size_bytes\": 142,\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /scripts\n\n現在の mind 内のすべてのスクリプトを一覧表示します。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\nスクリプトを削除します。\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## よくあるユースケース\n\n### デプロイスクリプト\n\n標準的なデプロイ手順を保存することで、LLM が毎回手順を再導出せずに実行できます。\n\n```bash\n# LLM stores this once\ncurl -X POST .../script -d '{\n \"name\": \"deploy-vps1\",\n \"content\": \"#!/bin/bash\\nssh vps1 \\\"cd /opt/synapse && git pull && docker compose up -d --build\\\"\",\n \"language\": \"bash\"\n}'\n\n# Later sessions just run it\ncurl -H \"Authorization: ...\" .../script/deploy-vps1 | bash\n```\n\n### トラブルシューティングスニペット\n\nよくある問題の診断コマンドを保存します。\n\n```bash\ncurl -X POST .../script -d '{\n \"name\": \"check-docker\",\n \"content\": \"#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df\",\n \"description\": \"Quick Docker health check\",\n \"language\": \"bash\"\n}'\n```\n\n### 設定ファイルジェネレータ\n\n設定を生成するスクリプトを保存します。\n\n```bash\ncurl -X POST .../script -d '{\n \"name\": \"gen-nginx-conf\",\n \"content\": \"#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...\",\n \"language\": \"python\"\n}'\n```\n\n## 次のステップ\n\n- [Variables API](/docs/api/variables)\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"

Scripts API

\n

Scripts API は再利用可能なスクリプトのための永続ストアを提供します。スクリプトは mind 内で名前付きかつバージョン管理され、プレーンテキストとして取得できます — curl | bash パターンに最適です。

\n

エンドポイント

\n

POST /script

\n

スクリプトを保存または更新します。

\n
curl -X POST https://synapse.schaefer.zone/script \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "deploy-synapse",\n    "content": "#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d",\n    "description": "Deploy Synapse to production",\n    "language": "bash"\n  }'

GET /script/:name

\n

スクリプトの内容を text/plain で取得します。bash にパイプするのに最適です。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse | bash

GET /script/:name/info

\n

内容を含まずにスクリプトのメタデータを取得します。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse/info

レスポンス：

\n
{\n  "name": "deploy-synapse",\n  "description": "Deploy Synapse to production",\n  "language": "bash",\n  "size_bytes": 142,\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\n}

GET /scripts

\n

現在の mind 内のすべてのスクリプトを一覧表示します。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/scripts

DELETE /script/:name

\n

スクリプトを削除します。

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse

よくあるユースケース

\n

デプロイスクリプト

\n

標準的なデプロイ手順を保存することで、LLM が毎回手順を再導出せずに実行できます。

\n
# LLM stores this once\ncurl -X POST .../script -d '{\n  "name": "deploy-vps1",\n  "content": "#!/bin/bash\\nssh vps1 \\"cd /opt/synapse && git pull && docker compose up -d --build\\"",\n  "language": "bash"\n}'\n\n# Later sessions just run it\ncurl -H "Authorization: ..." .../script/deploy-vps1 | bash

トラブルシューティングスニペット

\n

よくある問題の診断コマンドを保存します。

\n
curl -X POST .../script -d '{\n  "name": "check-docker",\n  "content": "#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df",\n  "description": "Quick Docker health check",\n  "language": "bash"\n}'

設定ファイルジェネレータ

\n

設定を生成するスクリプトを保存します。

\n
curl -X POST .../script -d '{\n  "name": "gen-nginx-conf",\n  "content": "#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...",\n  "language": "python"\n}'

次のステップ

\n\n","urls":{"html":"/docs/api/scripts","text":"/docs/api/scripts?format=text","json":"/docs/api/scripts?format=json","llm":"/docs/api/scripts?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}