Skip to main content

官方文档案例：KOPI Token Exchange、KOPI Shop、API Key 自动售卖、IPO Tracker

本指南展示如何将实际运营的网站和应用添加到 KOPI Agent 的官方文档中，以便用户了解和使用这些服务。

案例概览​

名称URL类型说明
KOPI Token Exchangehttp://ex.readinghero.xyz:8888API 交易平台买卖 KOPI token，提供 API 进行自动交易
KOPI Shophttps://sub.readinghero.xyz/prompt-shop/提示词/API Key 零售店销售精选提示词和 API Key，支持即时下载
API Key 自动售卖http://ex.readinghero.xyz:8088/api-key.html自动售卖系统自动生成并销售 API Key，支持多种模型
KOPI IPO Tracker (英文)https://story.happysocial.xyz/04.html数据仪表盘2026 年美股 IPO S-1 申报追踪，含公司分析、行业分布、月度统计，每日自动更新
KOPI IPO 追踪器 (中文)https://story.happysocial.xyz/04.html数据仪表盘中文版 IPO 追踪，2026 年美国 SEC S-1 申报全览，含行业分类与详细公司档案

KOPI IPO Tracker（英文版）​

🔗 URL：https://story.happysocial.xyz/04.html

核心功能​

  • 📊 实时 IPO 追踪：自动抓取 2026 年所有美股 S-1 申报，数据每日更新
  • 🏷️ 行业分类：按 SPAC、Biotech、Tech、Energy、Finance、Space 等行业标签筛选
  • 📈 月度统计：可视化月度 IPO 数量与金额趋势
  • 🔍 公司详情：每一家 IPO 公司含 S-1 摘要、行业标签、申报日期

使用场景​

  • 投资者快速浏览当前美股 IPO 市场热度
  • 金融分析师追踪行业 IPO 趋势
  • 量化交易团队获取 IPO 日历数据

技术实现​

  • 数据来源：SEC EDGAR 系统自动抓取
  • 更新频率：每日自动刷新
  • 风格：KOPI 品牌暖色系（cream + coffee + gold）

KOPI IPO 追踪器（中文版）​

🔗 URL：https://story.happysocial.xyz/04.html

核心功能​

  • 🇨🇳 全中文界面：面向中文用户的 IPO 数据追踪面板
  • 📊 完整数据覆盖：与英文版相同的数据源，覆盖 2026 年所有美国 SEC S-1 申报
  • 🏷️ 中文行业标签：SPAC · 生物科技 · 科技 · 能源 · 金融 · 航天等
  • 📈 统计卡片：已申报数量、活跃 IPO、已上市数量、SPAC 占比一目了然
  • 🖼️ 思源黑体 + Inter 字体：中英文混排美观

使用场景​

  • 中文投资者追踪美股 IPO 动态
  • 财经自媒体获取 IPO 日历素材
  • KOPI 生态内中文用户的数据入口

技术实现​

  • 与英文版共享数据源（SEC EDGAR）
  • 独立的中文界面与本地化标签
  • KOPI 品牌风格，响应式适配移动端

添加步骤​

1. 确定文档位置​

官方文档使用 Docusaurus 构建，源码位于：

.kopi/lib/kopi-agent/website/docs/

根据内容性质选择合适的目录：

  • 指南类（如何使用）：放在 docs/guides/ 下
  • 参考类（功能说明）：放在 docs/reference/ 下
  • 集成类（与其他平台对接）：放在 docs/integrations/ 下

本案例属于「官方服务介绍」，建议放在 docs/guides/ 下，新建文件 official-doc-examples.md（即当前文件）。

2. 编写 Markdown 内容​

使用上述 frontmatter（已生成），正文采用以下结构：

  • 案例概览表格（便于快速对比）
  • 每个案例的详细说明：
    • 核心功能
    • 使用场景
    • 访问方式（如需登录或 API Key 说明在哪里获取）
    • 常见问题或注意事项（如费率、限额等）
  • 如有截图或演示视频，可放在 static/img/ 并引用

3. 更新侧边栏​

编辑 sidebars.ts（位于 website/ 根目录），在适当的分类中添加条目：

export const guides = {
  guide: [
    'automate-with-cron',
    // ... 现有条目
    'official-doc-examples', // 新增
  ],
};

4. 本地预览​

# 在 website 目录
npm install # 仅首次需要
npm start   # 启动开发服务器 http://localhost:3000

访问 http://localhost:3000/guides/official-doc-examples 预览效果。

5. 构建与部署​

npm run build   # 生成静态文件到 build/
# 将 build/ 内容同步到服务器（例如 kopiaiagent.com）

部署后，访问 https://kopiaiagent.com/guides/official-doc-examples 确认无误。

注意事项​

  • 不暴露敏感凭证：文档中仅提供公开 URL 和一般使用说明，API Key、密钥等敏感信息应由用户在后台自行获取，文档中不得出现实际密钥。
  • 保持链接有效：若服务地址变更，需及时更新文档并重新部署。
  • 保持风格统一：参考现有案例（如 /docs/guides/daily-briefing-bot），使用相同的语气、格式和图标（如可用表情符号增强可读性）。

更新记录​

  • 2026-05-29：初始版本，添加 KOPI Token Exchange、KOPI Shop、API Key 自动售卖三个案例。
  • 2026-06-08：新增 KOPI IPO Tracker（英文版）和 KOPI IPO 追踪器（中文版）两个案例，含核心功能、使用场景、技术实现说明。

提示：如需添加更多官方服务案例，可复制本文件的结构，修改 frontmatter 和内容即可。