dataclaw-agent-kit 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# DataClaw Agent Kit 🦞
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> 一体化 DataClaw MCP Server 与 Agent Skills 命令行套件，为 Cursor、Claude Desktop、Windsurf 及其他 AI Agent 提供开箱即用的多媒体解析、音视频转写与社媒数据分析能力。
+
+---
+
+## ✨ 核心特性
+
+- **一体化极简分发**：单包发布，既提供交互式配置向导（`init`），又作为标准 `stdio` 协议的 MCP Server 运行（`mcp`）。
+- **零配置开箱即用**：终端一行 `npx dataclaw-agent-kit init` 自动探测本地 IDE 环境，一键注入 MCP 配置与预置场景技能 SOP。
+ - **10 个标准化 MCP Tools**：
+  - **多媒体域**：无水印视频解析（`dataclaw_video_resolve`）、智能语音转写（`dataclaw_audio_transcribe`，支持本地文件通过 `temp/mcp/` 预签名直传 R2 / OSS）。
+  - **抖音数据域**：热门视频检索、视频详情（互动数，不含播放量）、播放量查询（`dataclaw_dy_get_play_stats`）、评论列表、博主主页资料。
+  - **微信视频号域**：创作者检索、最新作品 Feed、分享链接无水印解析。
+- **场景化 Agent Skills**：预置 3 大高频场景 SOP（Markdown / MDC），指导 Agent 自动完成多工具链路组合与结果结构化排版。
+
+---
+
+## 🚀 快速上手
+
+### 1. 终端交互式安装（推荐）
+
+在您的项目根目录下运行：
+
+```bash
+npx dataclaw-agent-kit init
+```
+
+向导将引导您完成：
+1. 输入并验证您的 DataClaw API-Key；
+2. 选择需要注入的 AI 宿主（Cursor / Claude Desktop / Windsurf 等）；
+3. 勾选启用的第一期场景技能，自动生成规则文件与 MCP 配置。
+
+### 2. 手动配置 MCP 客户端
+
+如果需要在现有的 IDE 配置中手动接入，添加如下配置即可：
+
+#### Cursor (`.cursor/mcp.json`)
+```json
+{
+  "mcpServers": {
+    "dataclaw": {
+      "command": "npx",
+      "args": ["-y", "dataclaw-agent-kit", "mcp"],
+      "env": {
+        "DATACLAW_API_KEY": "您的_DATACLAW_API_KEY"
+      }
+    }
+  }
+}
+```
+
+#### Claude Desktop (`claude_desktop_config.json`)
+```json
+{
+  "mcpServers": {
+    "dataclaw": {
+      "command": "npx",
+      "args": ["-y", "dataclaw-agent-kit", "mcp"],
+      "env": {
+        "DATACLAW_API_KEY": "您的_DATACLAW_API_KEY"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🛠 本地开发与构建
+
+```bash
+# 安装依赖
+pnpm install
+
+# 类型检查
+pnpm typecheck
+
+# 打包构建 (输出到 dist/)
+pnpm build
+
+# 本地调试启动 MCP
+pnpm mcp
+
+# 本地调试运行向导
+pnpm init
+```
+
+---
+
+## 📄 开源许可
+
+MIT License.

package/bin/dataclaw-agent-kit.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/bin.js";

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/bin.js

@@ -0,0 +1,39 @@
+import {
+  runInitWizard,
+  startMcpServer
+} from "./chunk-CPFAA7NN.js";
+
+// src/bin.ts
+import { Command } from "commander";
+try {
+  process.loadEnvFile();
+} catch {
+}
+var program = new Command();
+program.name("dataclaw-agent-kit").description("DataClaw AI Agent Kit: MCP Server & Agent Skills CLI").version("0.1.1");
+program.command("init").description("\u542F\u52A8\u4EA4\u4E92\u5F0F\u914D\u7F6E\u5411\u5BFC\uFF0C\u81EA\u52A8\u6CE8\u5165 IDE MCP \u914D\u7F6E\u4E0E\u573A\u666F\u6280\u80FD SOP").action(async () => {
+  try {
+    await runInitWizard();
+  } catch (err) {
+    console.error("\u6267\u884C\u5B89\u88C5\u5411\u5BFC\u5F02\u5E38:", err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+});
+program.command("mcp").description("\u4EE5 stdio \u4F20\u8F93\u534F\u8BAE\u542F\u52A8 DataClaw MCP Server").action(async () => {
+  try {
+    await startMcpServer();
+  } catch (err) {
+    console.error("\u542F\u52A8 MCP Server \u5F02\u5E38:", err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+});
+if (process.argv.length <= 2) {
+  if (!process.stdin.isTTY) {
+    void startMcpServer();
+  } else {
+    program.help();
+  }
+} else {
+  program.parse(process.argv);
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["try {\n  process.loadEnvFile();\n} catch {\n  // 忽略不存在的 .env\n}\n\nimport { Command } from \"commander\";\nimport { startMcpServer } from \"./mcp/server.js\";\nimport { runInitWizard } from \"./cli/index.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"dataclaw-agent-kit\")\n  .description(\"DataClaw AI Agent Kit: MCP Server & Agent Skills CLI\")\n  .version(\"0.1.1\");\n\nprogram\n  .command(\"init\")\n  .description(\"启动交互式配置向导，自动注入 IDE MCP 配置与场景技能 SOP\")\n  .action(async () => {\n    try {\n      await runInitWizard();\n    } catch (err: unknown) {\n      console.error(\"执行安装向导异常:\", err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command(\"mcp\")\n  .description(\"以 stdio 传输协议启动 DataClaw MCP Server\")\n  .action(async () => {\n    try {\n      await startMcpServer();\n    } catch (err: unknown) {\n      console.error(\"启动 MCP Server 异常:\", err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// 处理无参数调用\nif (process.argv.length <= 2) {\n  // 如果标准输入不是 TTY（通常为 IDE 宿主作为子进程通过管道直接启动），默认启动 MCP Server\n  if (!process.stdin.isTTY) {\n    void startMcpServer();\n  } else {\n    program.help();\n  }\n} else {\n  program.parse(process.argv);\n}\n"],"mappings":";;;;;;AAMA,SAAS,eAAe;AANxB,IAAI;AACF,UAAQ,YAAY;AACtB,QAAQ;AAER;AAMA,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,oBAAoB,EACzB,YAAY,sDAAsD,EAClE,QAAQ,OAAO;AAElB,QACG,QAAQ,MAAM,EACd,YAAY,6IAAoC,EAChD,OAAO,YAAY;AAClB,MAAI;AACF,UAAM,cAAc;AAAA,EACtB,SAAS,KAAc;AACrB,YAAQ,MAAM,qDAAa,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAC3E,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF,CAAC;AAEH,QACG,QAAQ,KAAK,EACb,YAAY,uEAAoC,EAChD,OAAO,YAAY;AAClB,MAAI;AACF,UAAM,eAAe;AAAA,EACvB,SAAS,KAAc;AACrB,YAAQ,MAAM,yCAAqB,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AACnF,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF,CAAC;AAGH,IAAI,QAAQ,KAAK,UAAU,GAAG;AAE5B,MAAI,CAAC,QAAQ,MAAM,OAAO;AACxB,SAAK,eAAe;AAAA,EACtB,OAAO;AACL,YAAQ,KAAK;AAAA,EACf;AACF,OAAO;AACL,UAAQ,MAAM,QAAQ,IAAI;AAC5B;","names":[]}