{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4hsv5uhcg34z","handle":"sorftime-mcp","url":"https://wellknown.network/agents/sorftime-mcp","links":{"self":"https://wellknown.network/agents/sorftime-mcp/record.json","html":"https://wellknown.network/agents/sorftime-mcp","markdown":"https://wellknown.network/agents/sorftime-mcp/record.md","api":"https://wellknown.network/api/v1/agents/sorftime-mcp","status":"https://wellknown.network/api/v1/agents/sorftime-mcp/status","claim":"https://wellknown.network/agents/sorftime-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/sorftime-mcp/claim.json","badge":"https://wellknown.network/agents/sorftime-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/sorftime-mcp/history","tools":"https://wellknown.network/api/v1/agents/sorftime-mcp/tools"},"ard":{"identifier":"urn:air::server:sorftime-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"sorftime-mcp","summary":"Stdio MCP server for read-only Sorftime Enterprise API access.","description":"# Sorftime MCP\n\n把 Sorftime Enterprise API 封装成 Codex、Claude Code 等 AI Agent 可直接调用的 MCP 服务。\n\n本项目默认使用 `stdio` 模式，本地安装后只需要配置 `SORFTIME_API_KEY`。Sorftime Account-SK 保存在使用者自己的 MCP 客户端配置或服务器环境变量中，不写入代码仓库。\n\n## 重点\n\n- 默认传输：`stdio`\n- 本地必需环境变量：`SORFTIME_API_KEY`\n- 公开 MCP 工具数：10 个\n- 支持安全取数方法：32 个\n- 默认站点：`domain=1`，即美国站\n- 返回统一结构：`endpoint`、`domain`、`estimatedRequestCost`、`requestConsumed`、`requestLeft`、`code`、`message`、`data`、`rawResponse`\n- 默认排除账户修改、订阅管理、监控任务管理类接口\n\n## 安装方式\n\n### npm 安装\n\nCodex 配置：\n\n```toml\n[mcp_servers.sorftime]\ncommand = \"npx\"\nargs = [\"-y\", \"sorftime-mcp\"]\n\n[mcp_servers.sorftime.env]\nSORFTIME_API_KEY = \"你的 Sorftime Account-SK\"\n```\n\nClaude Code 安装：\n\n```bash\nclaude mcp add --scope user \\\n  -e SORFTIME_API_KEY=\"你的 Sorftime Account-SK\" \\\n  sorftime -- npx -y sorftime-mcp\n```\n\n### PyPI 安装\n\nCodex 配置：\n\n```toml\n[mcp_servers.sorftime]\ncommand = \"uvx\"\nargs = [\"sorftime-mcp\"]\n\n[mcp_servers.sorftime.env]\nSORFTIME_API_KEY = \"你的 Sorftime Account-SK\"\n```\n\nClaude Code 安装：\n\n```bash\nclaude mcp add --scope user \\\n  -e SORFTIME_API_KEY=\"你的 Sorftime Account-SK\" \\\n  sorftime -- uvx sorftime-mcp\n```\n\n### GitHub 源码安装\n\n```bash\nuvx --from git+https://github.com/ccchenhuohuo/sorftime-mcp.git sorftime-mcp\n```\n\n对应 Codex 配置：\n\n```toml\n[mcp_servers.sorftime]\ncommand = \"uvx\"\nargs = [\n  \"--from\",\n  \"git+https://github.com/ccchenhuohuo/sorftime-mcp.git\",\n  \"sorftime-mcp\"\n]\n\n[mcp_servers.sorftime.env]\nSORFTIME_API_KEY = \"你的 Sorftime Account-SK\"\n```\n\n## 工具列表\n\n| 工具 | 用途 |\n| --- | --- |\n| `sorftime_methods` | 查看支持的方法、分类、消耗、是否异步、是否有快捷工具 |\n| `sorftime_method_schema` | 查看单个方法的参数、示例、站点映射和消耗说明 |\n| `sorftime_call` | 白名单路由工具，用于调用低频安全取数方法 |\n| `product_request` | 产品详情，对应 `ProductRequest` |\n| `category_request` | 类目 Top 100，对应 `CategoryRequest` |\n| `keyword_request` | 关键词详情，对应 `KeywordRequest` |\n| `product_query` | 产品搜索，对应 `ProductQuery` |\n| `category_trend` | 类目趋势，对应 `CategoryTrend` |\n| `request_stream_month` | Request 使用和余额，对应 `RequestStreamMonth` |\n| `coin_query` | 积分余额，对应 `CoinQuery` |\n\n高频场景优先使用快捷工具。低频场景使用…","publisher":null,"homepage":null,"repository":"https://github.com/ccchenhuohuo/sorftime-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:sorftime-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.722,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"sorftime-mcp","registry":"pypi","observedAt":"2026-11-04T01:24:47.573Z","publishedAt":"2026-06-11T03:50:59.000502Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"sorftime-mcp","url":"https://pypi.org/project/sorftime-mcp/","firstSeenAt":"2026-09-10T12:22:59.471Z","fetchedAt":"2026-11-04T01:22:59.203Z","normalizedAt":"2026-11-04T01:22:59.203Z"}]},"firstSeenAt":"2026-09-10T12:22:59.471Z","updatedAt":"2026-11-04T01:24:47.573Z"}