{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bttvcmhkw3yw","handle":"iflow-mcp-kir4kami-mcp-steamdt","url":"https://wellknown.network/agents/iflow-mcp-kir4kami-mcp-steamdt","links":{"self":"https://wellknown.network/agents/iflow-mcp-kir4kami-mcp-steamdt/record.json","html":"https://wellknown.network/agents/iflow-mcp-kir4kami-mcp-steamdt","markdown":"https://wellknown.network/agents/iflow-mcp-kir4kami-mcp-steamdt/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-kir4kami-mcp-steamdt","status":"https://wellknown.network/api/v1/agents/iflow-mcp-kir4kami-mcp-steamdt/status","claim":"https://wellknown.network/agents/iflow-mcp-kir4kami-mcp-steamdt/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-kir4kami-mcp-steamdt/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-kir4kami-mcp-steamdt/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-kir4kami-mcp-steamdt/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-kir4kami-mcp-steamdt/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-kir4kami-mcp-steamdt","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_kir4kami_mcp-steamdt","summary":"SteamDT MCP server for querying CS2 item prices and market data","description":"## SteamDT MCP (Python)\n\n一个基于 Python 的 SteamDT 行情 / 数据分析 MCP 服务端，用于让支持 MCP 的大模型（如 Claude 等）可以直接调用 SteamDT 的开放接口，查询饰品行情并做基础分析。\n\n### 前置要求\n\n- Python 3.10 或更高版本\n- 已安装 git（用于方式一安装）\n- SteamDT API 密钥（在 [SteamDT 官网](https://steamdt.com) 注册后获取）\n\n### 快速开始\n\n#### 最简单的方式（推荐）✨\n\n1. **直接从 GitHub 安装**\n   ```bash\n   pip install git+https://github.com/Kir4kami/mcp-steamdt.git\n   ```\n\n2. **在 MCP 客户端中配置**\n   \n   编辑 Claude Desktop 配置文件（或其他 MCP 客户端），添加：\n   ```json\n   {\n     \"mcpServers\": {\n       \"steamdt\": {\n         \"command\": \"python\",\n         \"args\": [\"-m\", \"steamdt_mcp.server\"],\n         \"env\": {\n           \"STEAMDT_API_KEY\": \"你的密钥\"\n         }\n       }\n     }\n   }\n   ```\n\n3. **开始使用**\n   \n   重启客户端后，就可以在对话中让 AI 查询饰品价格、磨损度等信息了！\n\n> **提示**：`pip install git+...` 会自动下载并安装最新版本，无需手动克隆仓库。\n\n#### 开发模式（需要修改代码）\n\n如果你想修改代码或参与开发，可以克隆仓库后按照 [安装](#安装) 部分的说明进行配置。\n\n> ⚠️ 注意：\n> - 本项目未内置你的 API 密钥，也不会帮你绕过任何平台限制。请在遵守 SteamDT 官方服务条款的前提下使用。\n> - 本项目**只提供数据获取与基础统计功能，不做任何主观推荐或投资建议**；如何解读和使用这些数据，应由上层应用或用户自行决定。\n\n### 功能概览\n\n#### 基础信息与价格查询\n- `get_item_base_info`：获取所有饰品的基础信息（名称、marketHashName 等）。**自动管理本地缓存**，首次调用会请求 API 并保存，后续优先使用缓存，无需担心每天限 1 次的限制。\n- `search_item_by_name`：根据中文名或英文名搜索饰品，返回匹配的 `market_hash_name`。特别适合只知道中文名的情况。\n- `get_item_price`：根据 `market_hash_name` 查询单个饰品的当前价格信息（每分钟60次）。\n- `get_item_prices_batch`：批量查询多个饰品的价格信息（每分钟1次）。\n- `get_item_price_history`：查询指定饰品最近若干天的价格历史（30天均价数据）。\n\n#### 磨损度查询\n- `get_item_wear_by_inspect_url`：通过检视链接查询饰品的磨损度相关数据（每小时36000次）。\n- `get_item_wear_by_asmd`：通过 ASMD 参数查询饰品的磨损度相关数据（每小时36000次）。\n\n#### 价格历史查询\n- `get_item_price_history`：查询最近若干天的价格历史数据（30天均价）。根据 `market_hash_name` 和 `days` 参数查询各平台的30天平均价格。\n\n> 所有接口均基于 SteamDT 官方文档实现：`https://doc.steamdt.com/`。权限限制请参考官方文档。\n\n### 安装\n\n#### 方式一：直接从 GitHub 安装（推荐，最简单）✨\n\n无需克隆仓库，直接用 pip 从 GitHub 安装：\n\n```bash\npip install git+https://github.com/Kir4kami/mcp-steamdt.git\n```\n\n然后在 MCP 客户端配置中使用：\n\n```json\n{\n  \"mcpServers\": {\n    \"steamdt\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"steamdt_mcp.server\"],\n      \"env\": {\n        \"STEAMDT_API_KEY\": \"你的密钥\"\n  …","publisher":null,"homepage":"https://github.com/Kir4kami/mcp-steamdt","repository":"https://github.com/Kir4kami/mcp-steamdt","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_kir4kami_mcp-steamdt","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"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":"iflow-mcp_kir4kami_mcp-steamdt","registry":"pypi","observedAt":"2026-09-15T18:22:06.436Z","publishedAt":"2026-01-30T04:04:12.082173Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_kir4kami_mcp-steamdt","url":"https://pypi.org/project/iflow-mcp_kir4kami_mcp-steamdt/","firstSeenAt":"2026-09-09T19:24:32.295Z","fetchedAt":"2026-09-15T18:21:01.262Z","normalizedAt":"2026-09-15T18:21:01.262Z"}]},"firstSeenAt":"2026-09-09T19:24:32.295Z","updatedAt":"2026-09-15T18:22:06.439Z"}