Agent Access

Agent 接入

让你的 Agent 或业务平台直接读取 REALJOIN 的服务目录、公开价格和交付信息，辅助完成询价、订单意向与付款预览，并把需要确认的需求转到 Telegram。我们提供 Markdown、JSON API、OpenAPI、Skill、CLI 和本地 MCP。

获取 API Key 查看 Agent 目录

Service API

服务与价格

读取可售服务、公开报价、交付周期和所需字段。

/api/agent/services

Quote API

询价与议价

用用户 API Key 生成报价、预算说明和 Telegram 联系文案。

/api/agent/quote

Intent API

订单意向

为渠道平台或用户 Agent 创建可追踪的订单意向。

/api/agent/order-intents

Checkout API

付款订单

用用户 API Key 创建待付款订单，并返回可跳转的付款链接。

/api/agent/checkout

OpenAPI

接口规范

适配 GPT Actions、自动化工作流和外部 Agent 工具。

/api/agent/openapi.json

CLI

命令行工具

下载零依赖 Node CLI，在本地或服务器中调用 REALJOIN。

/realjoin-agent.mjs

MCP

本地 MCP 服务

通过 stdio 接入 Agent，写操作默认仅预览。

/agent/mcp.md

CLI 快速开始

用命令行把 REALJOIN 接入你的工作流

CLI 适合终端、服务器脚本和 Agent 工具链。目录可公开读取；询价、订单意向、付款订单和 Telegram 转接默认只生成预览，确认执行时才需要用户 API Key。

步骤 1

安装 CLI

npm install -g https://www.realjoin.io/realjoin-agent-kit-1.0.0.tgz

步骤 2

读取服务目录

node realjoin-agent.mjs services

步骤 3

设置 API Key

export REALJOIN_API_KEY="<your_api_key>"

步骤 4

预览付款订单

realjoin-agent checkout x-follow --target https://x.com/example --contact @telegram

Skill

给 Agent 的可读指令

Skill 文件会告诉外部 Agent 如何读取目录、选择服务、生成询价、创建订单意向、生成付款链接，并在需要人工确认时转到 Telegram。

npx -y skills add https://www.realjoin.io/agent/skill.md -g -y

打开 Skill 下载 CLI 查看 MCP

机器可读目录

完整服务与套餐数据已开放给 Agent

完整数据通过 Markdown、JSON 和 OpenAPI 提供。外部 Agent 可以读取全部服务、每个套餐价格、交付周期、必填字段和适用场景。

Telegram 联系

服务数量

全部上架服务均可被 Agent 检索。

套餐数量

108

每个服务的套餐、价格和交付信息均在详情中返回。

Markdown

/agent/services.md

适合 Agent 直接阅读和总结。

OpenAPI

/api/agent/openapi.json

适配 GPT Actions、自动化工具和外部平台。

打开 Markdown 目录查看服务 JSON OpenAPI

可审计接入流程

发现 → 询价 → 意向 → 审核 → 付款 → 状态回查

公开读取

目录、价格、必填字段和 OpenAPI 无需用户密钥即可读取，便于 Agent 先做服务匹配。

受控写入

询价、订单意向和结账使用用户 API Key。只给 Agent 所需权限，不要把密钥写入提示词、前端或公开日志。

人工审核

需要确认或存在平台风险的任务必须先转人工；API 返回可付款链接不代表客户可以绕过可接受使用政策。