内容层 搜索优化

怎么把 Fortuneteller.Today 接进你自己的 AI agent?

这页更适合什么问题与搜索意图?

先把适用场景、输入条件和阅读目标讲清楚,再进入对应工具页会更高效。

API 页面承接的是“我想用自己的 LLM 或 agent 直接调用网站术数能力”这类意图。它的重点不是只展示一个 key,而是把两种工作流讲清楚:一种只拿结果,由你的 agent 自己分析;另一种直接调用网站 analysis,消耗 credits,并把报告写回 Profile。

搜索“占卜 API”“术数 API”“LLM 调用排盘接口”或“agent 调用命盘分析”的用户,真正关心的是接入方式、输入流程、credits、结果回写和方法选择建议,而不是只有 endpoint 列表。

核心要点

  • 每个用户都可以生成自己的 API key
  • 支持 raw result 与 site analysis 两种模式
  • API 生成的 analysis 报告会像网站内报告一样进入 Profile 并带 API 标签

延伸场景

围绕常见高意图问题,补充更细的使用边界与判断角度。

什么时候该用 raw result 模式

如果你已经有自己的 LLM agent,希望它自己解读排盘、卦象或牌阵结果,就用 raw result 模式。这个模式不消耗网站 analysis credits,也不会在 Profile 里生成网站分析报告,更适合把 Fortuneteller.Today 当成底层术数引擎。

什么时候该用 site analysis 模式

如果你希望直接拿到网站生成的完整报告,并且让报告进入 Profile、支持历史查看和 API 标签筛选,就用 site analysis 模式。它会消耗 credits,但回传结果与站内正常使用保持一致。

为什么 API 页面要先讲方法选择与输入保真

真正的 agent 集成不只是“给一个 endpoint”。用户通常还需要知道先问一件事、看人生轨迹,还是看某个时间段专题;同时地点、生日、时间、性别、问题和主题都必须逐字段保真,不能被 agent 擅自改写。

常见问题

API 会覆盖哪些术数方法?

上线即覆盖站内全部术数方法。你的 agent 可以先用方法推荐接口判断适合哪一类,再读取对应方法的必填字段,最后提交 result API 或 analysis job。

API 调用会不会消耗 credits?

raw result 模式不会消耗网站 analysis credits;site analysis 模式会消耗 credits,因为它会调用网站自己的完整分析流程。

API 生成的报告会出现在 Profile 吗?

只有使用 site analysis 的 API 请求会在 Profile 里生成正常报告,并自动带上 API 标签,支持单独筛选。

为什么 API 页面还要教用户先区分问事、命运、推运?

因为这能大幅减少 agent 选错方法。先分清是在判断一件事、看人生结构,还是看某个时间段,再去选具体术数,会比直接乱试 endpoint 更稳定。

可继续延伸的话题

如果你还想继续比较方法、提问方式与使用边界,可以从这些主题往下读。

  • 怎么把术数网站接进自己的 agent
  • 什么时候该用 raw result 而不是 site analysis
  • API key 之外,agent 接入最常见的坑是什么
  • 为什么方法推荐接口比直接硬选术数更重要
  • 如何确保地点和出生信息在 agent 流程里不被改写