分类： 使用帮助

一星盘大师 Skill 是什么

星盘大师（AstroMaster，亚洲占星学院出品）开放平台把 14 项占星算力（本命排盘、个人运势、星座运势、过运盘、PDF 报告、调用记录等）对外开放，提供三种接入方式：

接入方式	适合谁	产物
Skill 包	想让 AI 助手”会看星盘”的用户	astro-skill.zip，解压即用
MCP 服务	使用支持 MCP 协议客户端的开发者	astro-mcp.zip 配置包
开放 API	自建系统的开发者	HTTPS 接口 api.astro.jiuchongju.com

三种方式共用同一个 API-KEY 与每日额度（默认 500 次/日，Skill 与 MCP 合并计数），计量口径完全一致，数据与官方客户端（PC 端 / 移动端 / APP）完全一致。本指南聚焦最常用的 Skill 包 路线。

二第一步：注册账号（以 jiuchongju001 为例）

1. 用电脑浏览器打开官网 https://astro.jiuchongju.com，点击右上角 「注册」（/register）；
2. 按下表填写并提交；
3. 提交成功后自动登录并进入首页，注册完成。

字段	示例值	说明
用户名	jiuchongju001	登录与展示用
密码	（自设强密码）	建议字母+数字+符号组合
昵称	如「星友」	展示用，可留空默认
性别	男 / 女	部分解读区分性别
出生日期	如 1995-08-20	星盘计算的默认个人信息
出生时间	如 08:30	影响上升星座与宫位
出生城市	如「杭州」	输入城市名自动匹配经纬度与时区

三第二步：创建 API-KEY

API-KEY 是你调用所有开放能力的”钥匙”，以 zs_ 开头（共 35 位）。

1. 登录后点击顶部导航的 「智能体」 进入「智能体配置」页，或直达 astro.jiuchongju.com/agent/api-keys；
2. 点击 「+ 创建密钥」，在弹窗填写密钥名称（可选）与有效期（30/90/180 天、1 年、2 年）；
3. 点 「确认创建」，弹出 「密钥已生成」 窗口，展示完整明文密钥（如 zs_9fK2...）；
4. 立即点击「复制」并妥善保存，再点「我已保存」关闭弹窗。

创建成功后列表出现一行记录：名称、密钥前缀、状态（有效）、有效期、每日限额 / 今日已用（默认 500）、已用额度与操作按钮。每个账号最多创建 5 个 API-KEY。

四（可选）申请提升每日额度

默认每个 KEY 每日 500 次调用，若不够用：

1. 在密钥列表对应行点击 「📈 申请提升每日额度」；
2. 在弹窗的「每日额度报价表」中选择期望档位（含免费档与付费档）；
3. 点 「提交申请」，系统返回申请编号（形如「申请编号为 APP…，联系管理员付费后开通」）；
4. 凭申请编号联系管理员付费开通；审批通过后新额度立即生效，列表状态显示「审核中」直至处理完成。

五第三步：导出 Skill 包

1. 在密钥列表对应行点击 「📦 导出 Skill」（导出 ClawHub 规范 Skill 包）；
2. 浏览器自动下载 astro-skill.zip；
3. 该包与你的 API-KEY 一一绑定：包内 config.json 已注入你的密钥，无需手动填写；
4. 每次导出都会在后台生成一条导出记录（skill_name = astro-skill），便于追溯。

六第四步：安装并使用 Skill 包

解压 astro-skill.zip，得到顶层目录 astro-skill/：

astro-skill/
├── SKILL.md          # ClawHub 技能说明（含 YAML frontmatter，声明 ASTRO_API_KEY 依赖）
├── config.json       # 账户与密钥配置（已填好：api_key / username / base_url / 有效期）
├── astro_client.py   # 独立可运行的 Python 客户端（含 401/429/503 错误处理）
├── requirements.txt  # Python 依赖（仅 requests）
└── README.md         # 使用说明

放入你的 Agent 平台技能目录：Claude Desktop / Claude Code 放入其 skills / plugins 目录；Qoder 放入工作区 .qoder/skills/；Cursor、ClawHub 等按各自技能加载规范放置。随后在对话中直接下达占星任务，Agent 会自动调用 Skill：

你：帮我排一下 1995 年 8 月 20 日 8 点半、出生地杭州、女的星盘。

Agent：（先用城市搜索取经纬度，再调用本命排盘）……返回行星落座、宫位、相位与完整解读。

Skill 覆盖的 14 项能力

1. 城市搜索（获取经纬度坐标与时区）
2. 个人信息补全（交互式收集出生信息）
3. 本命排盘计算
4. 个人每日运势
5. 个人本周运势
6. 个人本月运势
7. 个人本年运势
8. 十二星座每日运势
9. 指定星座每日运势
10. 指定星座本周运势
11. 指定星座本月运势
12. 指定星座本年运势
13. 查询最近调用记录
14. 官网注册引导

七（可选）改用 MCP 接入

若你的客户端支持 MCP 协议（Claude Desktop、Qoder、Cursor、阿里云百炼等），可免本地部署、直连云端：在密钥列表对应行点击 「🔌 导出 MCP」 下载 astro-mcp.zip，或手动配置云端端点：

{
  "mcpServers": {
    "星盘大师": {
      "type": "streamableHttp",
      "url": "https://api.astro.jiuchongju.com/mcp/astro/mcp",
      "headers": { "x-api-key": "zs_你的KEY" }
    }
  }
}

八查看用量、调用记录与 API 文档

• 用量与状态：「智能体配置 → API密钥」列表直接展示「每日限额 / 今日已用 / 有效期 / 状态」，页顶有总调用量、今日调用、本月调用、成功次数四张统计卡；
• 调用分析：「智能体配置 → 调用分析」页查看近期调用明细（仅保留最近 1 个月）；
• API 文档：「智能体配置 → API文档」（astro.jiuchongju.com/agent/api-docs），逐接口列出参数、鉴权方式与错误码；
• 鉴权方式：所有开放 API 请求需在 HTTP 请求头携带 X-API-Key。

九常见问题（FAQ）

密钥明文忘了保存怎么办？

在密钥列表对应行点「🔄 重新生成」，弹窗会再次展示新明文（旧密钥立即失效）。请当场复制。

调用返回 429 / 额度用尽怎么办？

说明当日 500 次额度用尽。可次日 0 点自动重置，或按第四节申请提升额度。

Skill 和 MCP 的额度是分开的吗？

不分开。同一 KEY 下 Skill 与 MCP 合并计数，共用每日 500 次（或你申请通过的额度）。

导出的 Skill 包能给别人用吗？

包内已绑定你的 API-KEY，他人使用将消耗你的额度。请勿外传；如需为他人开通，请让其自行注册并导出。

返回 401 是什么意思？

API 密钥无效或已过期。检查 config.json 里的 KEY 是否以 zs_ 开头、是否被重新生成过、是否已过有效期。

只能在电脑上用吗？

是。开放平台（API-KEY / Skill / MCP）目前仅在 PC 端 astro.jiuchongju.com 提供，移动端与 APP 暂不含该模块。

一星盘大师 MCP 是什么

MCP（Model Context Protocol）是一种让 AI 客户端调用外部能力的开放协议。星盘大师开放平台把占星算力封装为 11 个 MCP 工具，通过云端 MCP 端点暴露给你的客户端。接入后，你可以直接在对话里说”帮我排个星盘””看看我今天运势””天蝎本周运势如何”，客户端会自动调用对应工具并返回结果。所有成功输出末尾附数据来源署名：以上分析由「星盘大师」提供，官网：http://astro.jiuchongju.com。

形态	说明	适合谁
云端直连（推荐）	客户端直接连 https://api.astro.jiuchongju.com/mcp/astro/mcp，无需本地运行任何程序	绝大多数用户
本地 stdio	在本机运行导出的 mcp_server.py，兼容仅支持旧版 stdio 的客户端	旧版客户端用户

二第一步：注册账号（以 jiuchongju001 为例）

1. 用电脑浏览器打开官网 https://astro.jiuchongju.com，点击右上角 「注册」（/register）；
2. 填写：用户名 jiuchongju001、密码、昵称、性别、出生日期、出生时间、出生城市；
3. 提交后自动登录并进入首页，注册完成。

三第二步：创建 API-KEY

1. 登录后进入 「智能体」→「智能体配置」（或直达 astro.jiuchongju.com/agent/api-keys）；
2. 点 「+ 创建密钥」，填写密钥名称（可选）与有效期，点「确认创建」；
3. 弹窗展示明文密钥（zs_ 开头，共 35 位），立即复制保存（明文仅展示一次）；
4. 列表中长期显示密钥前缀。

四第三步：导出 MCP 包

1. 在密钥列表对应行点击 「🔌 导出 MCP」；
2. 浏览器下载 astro-mcp.zip；
3. 解压得到顶层目录 astro-mcp/。

astro-mcp/
├── mcp_server.py     # MCP Server 入口（本地 stdio 模式用）
├── astro_client.py   # 核心客户端库
├── config.json       # API 调用配置（含你的密钥）
├── requirements.txt  # Python 依赖（requests + mcp）
└── README.md         # 三种接入方式的完整说明

五第四步：在客户端导入并使用

5.1 云端直连（推荐）

无需安装 Python、无需运行本地进程。把下列配置合并进客户端的 MCP 配置：

• 阿里云百炼：控制台 →「MCP 管理」→「创建 MCP 服务」→ 选「使用脚本部署」→ 安装方式选 http → 粘贴下方配置 → 提交部署；
• Claude Desktop：编辑 claude_desktop_config.json 的 mcpServers 段；
• Cursor：编辑 .cursor/mcp.json；
• Qoder：在设置 → MCP 中添加下述 server。

{
  "mcpServers": {
    "星盘大师": {
      "type": "streamableHttp",
      "url": "https://api.astro.jiuchongju.com/mcp/astro/mcp",
      "headers": { "x-api-key": "zs_你的KEY" }
    }
  }
}

5.2 本地 stdio（仅限旧版客户端）

仅当客户端不支持远程 Streamable HTTP 时才需要：

pip install -r requirements.txt
export ASTRO_API_KEY="zs_你的KEY"
python mcp_server.py

{
  "mcpServers": {
    "astro-master": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": { "ASTRO_API_KEY": "zs_你的KEY" }
    }
  }
}

5.3 验证与调用示例

重启客户端后，应能看到名为 星盘大师（或 astro-master）的 server 处于已连接状态，并列出 11 个工具。

你：帮我排一下 1995 年 8 月 20 日 8 点半、出生地杭州、女的星盘。

客户端：（先调用 search_city 取经纬度，再调用 calculate_full_chart）……返回 9 大板块完整报告。

六MCP 工具速览（共 11 个）

类别	工具	说明
城市	search_city	按城市名搜索经纬度与时区（排盘前必用）
排盘	calculate_chart	本命排盘（基础版：行星落座、宫位、相位）
排盘	calculate_full_chart	全量排盘分析（9 大板块，推荐）
过运	calculate_transit	过运盘：过运行星、过运-本命相位与精确成相日期
报告	generate_pdf_report	生成本命盘 PDF 报告在线下载链接（48 小时有效）
运势	get_personal_daily_horoscope	个人今日运势（仅需出生日期）
运势	get_personal_horoscope	个人本周/本月/本年运势
运势	get_daily_horoscope	十二星座今日运势概况
运势	get_daily_horoscope_by_sign	指定星座今日运势详情
运势	get_sign_period_horoscope	指定星座本周/本月/本年运势
元信息	get_call_logs	查询当前 KEY 最近调用记录

完整入参说明见客户端连接后的工具列表，或官网 API 文档页 astro.jiuchongju.com/agent/api-docs。

七额度与调用记录

• 默认 500 次/日，MCP 与 Skill 合并计数，每日 0 点重置；
• 「智能体配置 → API密钥」查看每日限额 / 今日已用 / 状态；「调用分析」查看明细（仅保留最近 1 个月）；
• 调用 get_call_logs 查询最近调用；
• 需提升额度：在密钥行点「📈 申请提升每日额度」，选档位提交，凭申请编号联系管理员开通。

八常见问题（FAQ）

客户端提示连不上 / 不支持？

确认客户端支持远程 streamable-http MCP。仅支持旧版 stdio 的客户端请改用第五节 5.2 本地 stdio 形态。

KEY 应该放哪里？

放请求头 x-api-key（或 X-API-Key）。导出的 astro-mcp.zip 内 README.md 已按此写好。避免把 KEY 作为对话内容发给模型。

返回 401 / UNAUTHORIZED？

KEY 无效或缺失。检查请求头是否带上、KEY 是否以 zs_ 开头、是否被重新生成过、是否已过有效期。

返回 429 / QUOTA_EXCEEDED？

当日 500 次用尽。次日 0 点重置，或申请提升额度。

MCP 和 Skill 包有什么区别？

能力等价（同一套占星功能）。MCP 走协议直连，适合支持 MCP 的客户端；Skill 包是解压即用的技能目录。二者共用额度。

调用结果有可视化 / 报告吗？

calculate_full_chart 返回与移动端一致的格式化 Markdown 报告；generate_pdf_report 返回 PDF 在线下载链接（48 小时有效，无需登录）。

只能在电脑上导出吗？

是。开放平台（API-KEY / Skill / MCP）仅在 PC 端 astro.jiuchongju.com 提供。