{"id":"a839dc27-615e-461c-a47e-a26cb0430682","entityType":"agent","slug":"clawhub-tjefferson-stock-price-query","name":"股票查询 / Stock Price Query","canonicalUrl":"https://www.xpersona.co/agent/clawhub-tjefferson-stock-price-query","canonicalPath":"/agent/clawhub-tjefferson-stock-price-query","generatedAt":"2026-10-10T04:32:40.803Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T02:35:02.277Z","emptyReason":null},"description":"股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query fo... Skill: 股票查询 / Stock Price Query Owner: tjefferson Summary: 股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query fo... Tags: latest:1.2.1 Version history: v1.2.1 | 2026-04-19T04:27:11.732Z | user 规避 ClawHub 安全扫描器对 'API Key' 关键词的误判（skill 实际无需任何凭证）；新增数据实时性说明段落 v1.2.0 | 2026-04-19T03:22:43.675Z | user 优化 ClawHub 改版后的搜索可发","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 8.9K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s170z4mt16txtqsqz0ea9rph3183f336:stock-price-query","sourceUrl":"https://clawhub.ai/tjefferson/stock-price-query","homepage":"https://clawhub.ai/tjefferson/skills/stock-price-query","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/tjefferson/stock-price-query","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/tjefferson/skills/stock-price-query","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":73,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query fo..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:35:02.277Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:35:02.277Z","emptyReason":null},"stars":null,"forks":null,"downloads":8932,"packageName":null,"latestVersion":"1.2.1","tractionLabel":"8.9K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:35:02.277Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T02:35:02.277Z","lastCrawledAt":"2026-10-09T02:35:02.277Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T02:35:02.277Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.1","createdAt":"2026-04-19T04:27:11.732Z","changelog":"规避 ClawHub 安全扫描器对 'API Key' 关键词的误判（skill 实际无需任何凭证）；新增数据实时性说明段落","fileCount":5,"zipByteSize":11755},{"version":"1.2.0","createdAt":"2026-04-19T03:22:43.675Z","changelog":"优化 ClawHub 改版后的搜索可发现性：新增 Data & APIs 分类、description 中文关键词前置、display name 支持双语","fileCount":4,"zipByteSize":10246},{"version":"1.1.6","createdAt":"2026-04-09T11:30:34.060Z","changelog":"Fix search ranking: restore natural description, remove keyword stuffing that may have triggered spam filter","fileCount":7,"zipByteSize":15067},{"version":"1.1.5","createdAt":"2026-04-06T03:43:49.346Z","changelog":"SEO: optimize description and tags for better ClawHub search ranking","fileCount":7,"zipByteSize":15207},{"version":"1.1.4","createdAt":"2026-03-29T08:02:41.261Z","changelog":"Add pe_ratio and market_cap fields when available from data source. Add --version flag. Restore CHANGELOG.md and README.md documentation.","fileCount":6,"zipByteSize":14391},{"version":"1.1.3","createdAt":"2026-03-26T04:24:33.120Z","changelog":"- Removed documentation files: CHANGELOG.md and README.md. - No changes to the skill’s code or functionality. - The skill’s interface, usage, and features remain unchanged.","fileCount":4,"zipByteSize":9892},{"version":"1.1.2","createdAt":"2026-03-24T00:37:51.290Z","changelog":"精简tags","fileCount":6,"zipByteSize":13811},{"version":"1.1.1","createdAt":"2026-03-24T00:01:57.422Z","changelog":"**Batch stock quote and index support added.** - 支持批量同时查询多只股票，提升多股对比与 watchlist 场景体验。 - 覆盖大盘指数（如上证、恒指、纳指，道琼斯等）行情查询，支持主流中英文别名。 - 输入安全校验增强，批量模式下单次最多支持 20 只股票，部分失败友好提示。 - 输出格式新增批量展示规范，单只/批量均优化涨跌视觉表现。 - 元数据与 description 增补“批量”、“指数”等关键词标签，便于筛选及调用。","fileCount":4,"zipByteSize":10014}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s170z4mt16txtqsqz0ea9rph3183f336:stock-price-query","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T04:32:40.800Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tjefferson-stock-price-query/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T02:35:02.277Z","emptyReason":null},"readme":"Skill: 股票查询 / Stock Price Query\n\nOwner: tjefferson\n\nSummary: 股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query fo...\n\nTags: latest:1.2.1\n\nVersion history:\n\nv1.2.1 | 2026-04-19T04:27:11.732Z | user\n\n规避 ClawHub 安全扫描器对 'API Key' 关键词的误判（skill 实际无需任何凭证）；新增数据实时性说明段落\n\nv1.2.0 | 2026-04-19T03:22:43.675Z | user\n\n优化 ClawHub 改版后的搜索可发现性：新增 Data & APIs 分类、description 中文关键词前置、display name 支持双语\n\nv1.1.6 | 2026-04-09T11:30:34.060Z | user\n\nFix search ranking: restore natural description, remove keyword stuffing that may have triggered spam filter\n\nv1.1.5 | 2026-04-06T03:43:49.346Z | user\n\nSEO: optimize description and tags for better ClawHub search ranking\n\nv1.1.4 | 2026-03-29T08:02:41.261Z | user\n\nAdd pe_ratio and market_cap fields when available from data source. Add --version flag. Restore CHANGELOG.md and README.md documentation.\n\nv1.1.3 | 2026-03-26T04:24:33.120Z | auto\n\n- Removed documentation files: CHANGELOG.md and README.md.\n- No changes to the skill’s code or functionality.\n- The skill’s interface, usage, and features remain unchanged.\n\nv1.1.2 | 2026-03-24T00:37:51.290Z | user\n\n精简tags\n\nv1.1.1 | 2026-03-24T00:01:57.422Z | user\n\n**Batch stock quote and index support added.**\n\n- 支持批量同时查询多只股票，提升多股对比与 watchlist 场景体验。\n- 覆盖大盘指数（如上证、恒指、纳指，道琼斯等）行情查询，支持主流中英文别名。\n- 输入安全校验增强，批量模式下单次最多支持 20 只股票，部分失败友好提示。\n- 输出格式新增批量展示规范，单只/批量均优化涨跌视觉表现。\n- 元数据与 description 增补“批量”、“指数”等关键词标签，便于筛选及调用。\n\nv1.0.7 | 2026-03-12T14:48:40.974Z | auto\n\n- Clarified that the script only accepts stock codes as input and does not support direct Chinese (or English) stock name queries.\n- Added instructions for agents to perform name-to-code mapping based on a provided table before calling the script.\n- Updated \"Edge Cases\" to specify that stock names not in the mapping table should prompt the user for a stock code, and that agents are responsible for this logic.\n- No changes to APIs, system requirements, or usage for end users.\n\nv1.0.6 | 2026-03-12T14:43:19.327Z | auto\n\n- Updated the skill description for brevity and clarity, emphasizing trigger conditions and supported markets.\n- Made the skill's use cases and trigger logic more explicit in the documentation intro.\n- No changes to scripts or functionality; this update only refines SKILL.md documentation content.\n\nv1.0.5 | 2026-03-12T14:35:20.823Z | auto\n\n- Added detailed tags and refined description for improved discoverability and clarity in skill metadata.\n- Explicitly states no API key or runtime dependencies are needed.\n- Improved and clarified Chinese and English descriptions for a broader audience.\n- Enhanced bullet points and format in trigger and example usage for concise, chat-friendly communication.\n- No changes to technical behavior or output format.\n\nv1.0.4 | 2026-02-26T11:48:06.405Z | auto\n\n- Output format for stock query results is now more compact, removing the long table and avoiding Feishu message pagination.\n- Amount values are converted to \"亿\" or \"万\" units for better readability when large.\n- Removed redundant documents: CHANGELOG.md and README.md.\n- No behavioral or API changes; all query and edge-case handling remains as before.\n\nv1.0.3 | 2026-02-25T08:37:04.465Z | auto\n\nVersion 1.0.3\n\n- Added strict input validation for stock code and market parameters to prevent command injection and ensure input safety.\n- Updated documentation to clarify input restrictions (only allow alphanumeric stock codes and whitelist markets).\n- Improved error handling for invalid or unsafe input cases.\n\nv1.0.2 | 2026-02-25T04:23:51.071Z | auto\n\n- Adds detailed usage and trigger criteria for querying real-time prices of A-shares, Hong Kong stocks, and US stocks.\n- Explains how stock codes and market types are parsed automatically from user input or selected from a mapping table.\n- Provides sample query script usage, expected output format, and comprehensive guidance for both standard and edge-case scenarios.\n- Introduces clear error messages and self-healing suggestions in response to invalid codes, network errors, market closures, or API rate limits.\n- Standardizes the user-facing response format for a more user-friendly presentation of stock data.\n\nArchive index:\n\nArchive v1.2.1: 5 files, 11755 bytes\n\nFiles: references/api-docs.md (2370b), scripts/stock_query.py (13351b), skill-card.md (2278b), SKILL.md (8778b), _meta.json (136b)\n\nFile v1.2.1:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query for A-shares (Shanghai/Shenzhen), Hong Kong and US stocks. Batch query up to 20 symbols. Zero configuration, ready to use out of the box.\"\ncategory: Data & APIs\nmetadata:\n  openclaw:\n    emoji: \"📈\"\n    requires:\n      bins: [python3]\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，零配置开箱即用，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and zero configuration.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情接口获取数据，返回结构化的股票信息。\n\n### 数据实时性说明\n\n- **A 股**：交易时段内**实时行情**（秒级更新）\n- **港股 / 美股**：按境外交易所（HKEX / NYSE / NASDAQ）行情授权规定，免费公开接口为**延迟约 15 分钟行情**。如需港股/美股 Level-1 实时行情，请使用付费持牌渠道\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象（`pe_ratio` 和 `market_cap` 在数据源可用时返回）：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"pe_ratio\": 28.35,\n  \"market_cap\": 2120000000000.00,\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n📐 市盈率：{pe_ratio} | 总市值：{market_cap}（如有）\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.2.1:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.2.1\",\n  \"publishedAt\": 1776572831732\n}\n\nFile v1.2.1:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，直接调用公开接口，无需任何配置。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nFile v1.2.1:skill-card.md\n\n## Description:\n\nQueries current stock quotes and market index data for A-shares, Hong Kong stocks, US stocks, and major indexes, with single-symbol and batch lookup support.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[tjefferson](https://clawhub.ai/user/tjefferson)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to look up stock symbols or common mapped stock names and return compact quote summaries for A-share, Hong Kong, US equities, and major market indexes.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Queried stock symbols are sent to Tencent's public quote API.\n\nMitigation: Use the skill only when this third-party market-data request is acceptable, and avoid submitting symbols whose disclosure would be sensitive.\n\nRisk: Hong Kong and US market data from the free public endpoint may be delayed, and non-trading periods may return recent close data.\n\nMitigation: Treat results as informational market data and verify time-sensitive or regulated decisions with an authorized market-data source.\n\nRisk: The public endpoint may rate limit or fail due to network availability.\n\nMitigation: Use light retry behavior and clearly report unavailable or partial results rather than presenting missing data as current.\n\n## Reference(s):\n\n- [股票查询 API 参考文档](references/api-docs.md)\n- [Tencent public quote API endpoint](https://qt.gtimg.cn/q={symbol})\n- [ClawHub skill page](https://clawhub.ai/tjefferson/skills/stock-price-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, JSON, guidance]\n\n**Output Format:** [JSON from the query script and concise Markdown quote summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Supports single-symbol lookup or comma-separated batches up to 20 symbols; requires python3 and network access to Tencent's public quote API.]\n\n## Skill Version(s):\n\n1.2.1 (source: ClawHub release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.2.0: 4 files, 10246 bytes\n\nFiles: references/api-docs.md (2361b), scripts/stock_query.py (13340b), SKILL.md (8429b), _meta.json (136b)\n\nFile v1.2.0:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，无需 API Key。Real-time stock price, quote and market index query for A-shares (Shanghai/Shenzhen), Hong Kong and US stocks. Batch query up to 20 symbols. No API key required.\"\ncategory: Data & APIs\nmetadata:\n  openclaw:\n    emoji: \"📈\"\n    requires:\n      bins: [python3]\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象（`pe_ratio` 和 `market_cap` 在数据源可用时返回）：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"pe_ratio\": 28.35,\n  \"market_cap\": 2120000000000.00,\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n📐 市盈率：{pe_ratio} | 总市值：{market_cap}（如有）\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.2.0\",\n  \"publishedAt\": 1776568963675\n}\n\nFile v1.2.0:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nArchive v1.1.6: 7 files, 15067 bytes\n\nFiles: CHANGELOG.md (3602b), README.md (3905b), references/api-docs.md (2361b), scripts/check_rank.sh (966b), scripts/stock_query.py (13340b), SKILL.md (8283b), _meta.json (136b)\n\nFile v1.1.6:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"实时股票价格查询，支持 A 股、港股、美股及大盘指数的批量查询，无需 API Key。Real-time stock price query for A-shares, Hong Kong and US stock markets, with batch support and market index. No API key required.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象（`pe_ratio` 和 `market_cap` 在数据源可用时返回）：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"pe_ratio\": 28.35,\n  \"market_cap\": 2120000000000.00,\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n📐 市盈率：{pe_ratio} | 总市值：{market_cap}（如有）\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.1.6:README.md\n\n# 📈 stock-price-query\n\nAn [OpenClaw](https://github.com/openclaw/openclaw) skill for querying real-time stock prices across multiple markets.\n\n## Features\n\n- **Multi-market support**: A-shares (Shanghai & Shenzhen), Hong Kong stocks, and US stocks\n- **Auto market detection**: Automatically identifies the market based on stock code format\n- **Batch query**: Query up to 20 stocks in a single call with comma-separated codes\n- **Extended data**: PE ratio and market cap included when available from data source\n- **Zero dependencies**: Pure Python 3 standard library, no external packages required\n- **Structured output**: Returns JSON with price, change, volume, PE ratio, market cap and more\n\n## Supported Markets\n\n| Market | Code Format | Example |\n|--------|------------|---------|\n| Shanghai (SH) | 6-digit starting with 6 | `600519` (Kweichow Moutai) |\n| Shenzhen (SZ) | 6-digit starting with 0/3 | `300750` (CATL) |\n| Hong Kong (HK) | Up to 5 digits, or index code | `00700` (Tencent), `HSI` (Hang Seng Index) |\n| US | Alphabetic ticker, or `.`-prefixed index | `AAPL` (Apple), `.IXIC` (NASDAQ) |\n\n### Market Indices\n\n| Index | Code | Market |\n|-------|------|--------|\n| SSE Composite (上证指数) | `000001` | sh |\n| SZSE Component (深证成指) | `399001` | sz |\n| ChiNext (创业板指) | `399006` | sz |\n| Hang Seng Index (恒生指数) | `HSI` | hk |\n| HSCEI (国企指数) | `HSCEI` | hk |\n| NASDAQ Composite (纳斯达克) | `.IXIC` | us |\n| Dow Jones (道琼斯) | `.DJI` | us |\n| S&P 500 (标普500) | `.INX` | us |\n\n## Usage\n\n### As an OpenClaw Skill\n\nCopy this repository to your OpenClaw skills directory:\n\n```bash\n# User-level\ncp -r stock-price-query ~/.openclaw/skills/\n\n# Or project-level\ncp -r stock-price-query /path/to/project/skills/\n```\n\nThen ask naturally in OpenClaw:\n\n- \"What's the current price of AAPL?\"\n- \"查一下贵州茅台的股价\"\n- \"How is Tencent doing today?\"\n\n### Standalone\n\n```bash\npython3 scripts/stock_query.py <stock_code> [market]\n\n# Examples — Individual stocks\npython3 scripts/stock_query.py 600519        # A-share (auto-detect)\npython3 scripts/stock_query.py AAPL          # US stock\npython3 scripts/stock_query.py 00700 hk      # Hong Kong stock\n\n# Examples — Market indices\npython3 scripts/stock_query.py 000001 sh     # SSE Composite (上证指数)\npython3 scripts/stock_query.py HSI           # Hang Seng Index (恒生指数)\npython3 scripts/stock_query.py .IXIC         # NASDAQ Composite (纳斯达克)\npython3 scripts/stock_query.py .DJI          # Dow Jones (道琼斯)\n\n# Examples — Batch query (mixed stocks & indices)\npython3 scripts/stock_query.py .IXIC,HSI,600519,AAPL\n```\n\n### Output Example\n\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1466.80,\n  \"change\": -18.50,\n  \"change_percent\": -1.25,\n  \"open\": 1521.00,\n  \"high\": 1524.40,\n  \"low\": 1463.60,\n  \"prev_close\": 1485.30,\n  \"volume\": 4191300,\n  \"amount\": 6198840000.00,\n  \"time\": \"20260224161416\",\n  \"status\": \"success\"\n}\n```\n\n### Display Example (via OpenClaw + Feishu)\n\nWhen queried through OpenClaw in Feishu, the result is displayed in a compact format:\n\n```\n📈 贵州茅台（600519.sh）\n\n💰 当前价格：1466.80 元 | 📊 涨跌幅：-18.50 (-1.25%) ↓\n📅 行情时间：2026/02/24 16:14:16\n📊 今开 1521.00 | 最高 1524.40 | 最低 1463.60 | 昨收 1485.30\n📦 成交量：4,191,300 | 成交额：61.99亿\n```\n\n## Project Structure\n\n```\nstock-price-query/\n├── SKILL.md              # OpenClaw skill definition\n├── CHANGELOG.md          # Version history\n├── README.md             # This file\n├── scripts/\n│   └── stock_query.py    # Query script (Python 3)\n└── references/\n    └── api-docs.md       # API documentation\n```\n\n## Data Source\n\nUses Tencent Finance API (`qt.gtimg.cn`) — free, no API key required, no special headers needed.\n\n## License\n\nMIT\n\nFile v1.1.6:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.1.6\",\n  \"publishedAt\": 1775734234060\n}\n\nFile v1.1.6:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nFile v1.1.6:CHANGELOG.md\n\n# Changelog\n\n## v1.1.4 (2026-03-29)\n\n### Added\n- **市盈率与市值数据**：查询结果新增 `pe_ratio`（市盈率）和 `market_cap`（总市值）字段，在数据源可用时自动返回\n- **版本号查询**：支持 `--version` / `-V` 参数查看脚本版本\n\n### Changed\n- SKILL.md 输出格式说明新增市盈率和市值展示\n- 恢复 CHANGELOG.md 和 README.md 文档\n\n## v1.1.3 (2026-03-23)\n\n### Changed\n- Removed documentation files: CHANGELOG.md and README.md\n\n## v1.1.2 (2026-03-23)\n\n### Changed\n- Minor metadata updates\n\n## v1.1.1 (2026-03-23)\n\n### Fixed\n- **美股指数代码支持**：修复 `.IXIC`（纳斯达克）、`.DJI`（道琼斯）、`.INX`（标普500）等以 `.` 开头的指数代码被输入校验正则拦截的问题，正则从 `^[A-Za-z0-9]{1,10}$` 改为 `^\\.?[A-Za-z0-9]{1,10}$`\n- **港股指数市场识别**：`HSI`（恒生指数）、`HSCEI`（国企指数）等纯字母港股指数代码之前被 `detect_market` 误判为美股，新增 `HK_INDEX_CODES` 白名单优先匹配港股指数\n- **港股指数代码格式**：`build_tencent_symbol` 和 `parse_stock` 中港股指数不再做 `zfill(5)` 补零，避免生成无效代码如 `0HSI`\n\n## v1.1.0 (2026-03-23)\n\n### Added\n- **批量查询**：支持一次查询多只股票（逗号分隔），单次 HTTP 请求获取全部数据，最多 20 只\n- **大盘指数映射**：新增上证指数、深证成指、创业板指、恒生指数、纳斯达克、道琼斯、标普500 等指数代码映射\n- **扩大股票映射表**：从 10 只扩展至 21 只热门个股，新增招商银行、工商银行、五粮液、美的、美团、小米、京东、谷歌、亚马逊、Meta 等\n\n### Changed\n- SKILL.md description 优化，新增批量查询、大盘指数等高频搜索关键词\n- SKILL.md tags 从 17 个扩展至 30 个，覆盖更多搜索场景\n- 输出格式新增批量查询的紧凑对比展示格式，涨跌使用 🟢/🔴 颜色标识\n\n## v1.0.4 (2026-02-26)\n\n### Changed\n- SKILL.md 输出格式从 Markdown 表格改为紧凑多行格式，避免飞书消息卡片分页\n- 价格与涨跌幅合并为一行展示\n- 成交量与成交额合并为一行展示\n- 成交额增加人性化单位（亿/万）显示要求\n- README.md 新增最终显示格式示例\n\n## v1.0.3 (2026-02-25)\n\n### Security\n- 新增输入安全校验，stock_code 仅允许字母和数字（`^[A-Za-z0-9]{1,10}$`），market 使用白名单（sh/sz/hk/us），防止 shell 命令注入\n- SKILL.md 增加输入安全校验说明\n- 解决 ClawHub VirusTotal 扫描报告中的 Suspicious 标记\n\n## v1.0.2 (2026-02-24)\n\n### Reverted\n- 移除 stock_query.sh wrapper 脚本，保持纯 .py 脚本方案\n- SKILL.md 调用方式还原为直接 python3 调用\n\n## v1.0.1 (2026-02-24)\n\n### Changed\n- 数据源从新浪财经 API (hq.sinajs.cn) 切换为腾讯财经 API (qt.gtimg.cn)，解决 403 Forbidden 问题\n- 腾讯 API 无需 Referer Header，稳定性更好\n- 统一了各市场（A 股/港股/美股）的数据解析逻辑，代码更简洁\n- 更新 references/api-docs.md 为腾讯 API 文档\n\n## v1.0.0 (2026-02-24)\n\n### Added\n- 初版发布，支持查询股票实时价格\n- 支持 A 股沪市（sh）、A 股深市（sz）、港股（hk）、美股（us）四个市场\n- 自动识别股票代码所属市场\n- 零外部依赖，纯 Python 标准库实现\n- 返回结构化 JSON 数据（当前价、涨跌幅、开高低收、成交量等）\n- API 限流自动重试机制\n- 提供 API 参考文档（references/api-docs.md）\n- SKILL.md 元数据格式对齐 OpenClaw 官方示例规范\n\nArchive v1.1.5: 7 files, 15207 bytes\n\nFiles: CHANGELOG.md (3602b), README.md (3905b), references/api-docs.md (2361b), scripts/check_rank.sh (966b), scripts/stock_query.py (13340b), SKILL.md (8593b), _meta.json (136b)\n\nFile v1.1.5:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"股票查询｜股价监控｜实时行情：A股/港股/美股股票价格查询，大盘指数，批量查询，无需API Key。Stock price checker & monitor for A-shares, HK & US markets. Real-time quotes, market index, batch query. No API key.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n        \"tags\": [\"stock\", \"stock-price\", \"stock-query\", \"stock-monitor\", \"stock-checker\", \"stock-market\", \"finance\", \"A-shares\", \"Hong-Kong\", \"US-stocks\", \"market-index\", \"tencent-finance\", \"股票\", \"股价\", \"股票查询\", \"股票价格\", \"行情\", \"港股\", \"美股\", \"A股\", \"大盘\", \"指数\"],\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象（`pe_ratio` 和 `market_cap` 在数据源可用时返回）：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"pe_ratio\": 28.35,\n  \"market_cap\": 2120000000000.00,\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n📐 市盈率：{pe_ratio} | 总市值：{market_cap}（如有）\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.1.5:README.md\n\n# 📈 stock-price-query\n\nAn [OpenClaw](https://github.com/openclaw/openclaw) skill for querying real-time stock prices across multiple markets.\n\n## Features\n\n- **Multi-market support**: A-shares (Shanghai & Shenzhen), Hong Kong stocks, and US stocks\n- **Auto market detection**: Automatically identifies the market based on stock code format\n- **Batch query**: Query up to 20 stocks in a single call with comma-separated codes\n- **Extended data**: PE ratio and market cap included when available from data source\n- **Zero dependencies**: Pure Python 3 standard library, no external packages required\n- **Structured output**: Returns JSON with price, change, volume, PE ratio, market cap and more\n\n## Supported Markets\n\n| Market | Code Format | Example |\n|--------|------------|---------|\n| Shanghai (SH) | 6-digit starting with 6 | `600519` (Kweichow Moutai) |\n| Shenzhen (SZ) | 6-digit starting with 0/3 | `300750` (CATL) |\n| Hong Kong (HK) | Up to 5 digits, or index code | `00700` (Tencent), `HSI` (Hang Seng Index) |\n| US | Alphabetic ticker, or `.`-prefixed index | `AAPL` (Apple), `.IXIC` (NASDAQ) |\n\n### Market Indices\n\n| Index | Code | Market |\n|-------|------|--------|\n| SSE Composite (上证指数) | `000001` | sh |\n| SZSE Component (深证成指) | `399001` | sz |\n| ChiNext (创业板指) | `399006` | sz |\n| Hang Seng Index (恒生指数) | `HSI` | hk |\n| HSCEI (国企指数) | `HSCEI` | hk |\n| NASDAQ Composite (纳斯达克) | `.IXIC` | us |\n| Dow Jones (道琼斯) | `.DJI` | us |\n| S&P 500 (标普500) | `.INX` | us |\n\n## Usage\n\n### As an OpenClaw Skill\n\nCopy this repository to your OpenClaw skills directory:\n\n```bash\n# User-level\ncp -r stock-price-query ~/.openclaw/skills/\n\n# Or project-level\ncp -r stock-price-query /path/to/project/skills/\n```\n\nThen ask naturally in OpenClaw:\n\n- \"What's the current price of AAPL?\"\n- \"查一下贵州茅台的股价\"\n- \"How is Tencent doing today?\"\n\n### Standalone\n\n```bash\npython3 scripts/stock_query.py <stock_code> [market]\n\n# Examples — Individual stocks\npython3 scripts/stock_query.py 600519        # A-share (auto-detect)\npython3 scripts/stock_query.py AAPL          # US stock\npython3 scripts/stock_query.py 00700 hk      # Hong Kong stock\n\n# Examples — Market indices\npython3 scripts/stock_query.py 000001 sh     # SSE Composite (上证指数)\npython3 scripts/stock_query.py HSI           # Hang Seng Index (恒生指数)\npython3 scripts/stock_query.py .IXIC         # NASDAQ Composite (纳斯达克)\npython3 scripts/stock_query.py .DJI          # Dow Jones (道琼斯)\n\n# Examples — Batch query (mixed stocks & indices)\npython3 scripts/stock_query.py .IXIC,HSI,600519,AAPL\n```\n\n### Output Example\n\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1466.80,\n  \"change\": -18.50,\n  \"change_percent\": -1.25,\n  \"open\": 1521.00,\n  \"high\": 1524.40,\n  \"low\": 1463.60,\n  \"prev_close\": 1485.30,\n  \"volume\": 4191300,\n  \"amount\": 6198840000.00,\n  \"time\": \"20260224161416\",\n  \"status\": \"success\"\n}\n```\n\n### Display Example (via OpenClaw + Feishu)\n\nWhen queried through OpenClaw in Feishu, the result is displayed in a compact format:\n\n```\n📈 贵州茅台（600519.sh）\n\n💰 当前价格：1466.80 元 | 📊 涨跌幅：-18.50 (-1.25%) ↓\n📅 行情时间：2026/02/24 16:14:16\n📊 今开 1521.00 | 最高 1524.40 | 最低 1463.60 | 昨收 1485.30\n📦 成交量：4,191,300 | 成交额：61.99亿\n```\n\n## Project Structure\n\n```\nstock-price-query/\n├── SKILL.md              # OpenClaw skill definition\n├── CHANGELOG.md          # Version history\n├── README.md             # This file\n├── scripts/\n│   └── stock_query.py    # Query script (Python 3)\n└── references/\n    └── api-docs.md       # API documentation\n```\n\n## Data Source\n\nUses Tencent Finance API (`qt.gtimg.cn`) — free, no API key required, no special headers needed.\n\n## License\n\nMIT\n\nFile v1.1.5:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.1.5\",\n  \"publishedAt\": 1775447029346\n}\n\nFile v1.1.5:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nFile v1.1.5:CHANGELOG.md\n\n# Changelog\n\n## v1.1.4 (2026-03-29)\n\n### Added\n- **市盈率与市值数据**：查询结果新增 `pe_ratio`（市盈率）和 `market_cap`（总市值）字段，在数据源可用时自动返回\n- **版本号查询**：支持 `--version` / `-V` 参数查看脚本版本\n\n### Changed\n- SKILL.md 输出格式说明新增市盈率和市值展示\n- 恢复 CHANGELOG.md 和 README.md 文档\n\n## v1.1.3 (2026-03-23)\n\n### Changed\n- Removed documentation files: CHANGELOG.md and README.md\n\n## v1.1.2 (2026-03-23)\n\n### Changed\n- Minor metadata updates\n\n## v1.1.1 (2026-03-23)\n\n### Fixed\n- **美股指数代码支持**：修复 `.IXIC`（纳斯达克）、`.DJI`（道琼斯）、`.INX`（标普500）等以 `.` 开头的指数代码被输入校验正则拦截的问题，正则从 `^[A-Za-z0-9]{1,10}$` 改为 `^\\.?[A-Za-z0-9]{1,10}$`\n- **港股指数市场识别**：`HSI`（恒生指数）、`HSCEI`（国企指数）等纯字母港股指数代码之前被 `detect_market` 误判为美股，新增 `HK_INDEX_CODES` 白名单优先匹配港股指数\n- **港股指数代码格式**：`build_tencent_symbol` 和 `parse_stock` 中港股指数不再做 `zfill(5)` 补零，避免生成无效代码如 `0HSI`\n\n## v1.1.0 (2026-03-23)\n\n### Added\n- **批量查询**：支持一次查询多只股票（逗号分隔），单次 HTTP 请求获取全部数据，最多 20 只\n- **大盘指数映射**：新增上证指数、深证成指、创业板指、恒生指数、纳斯达克、道琼斯、标普500 等指数代码映射\n- **扩大股票映射表**：从 10 只扩展至 21 只热门个股，新增招商银行、工商银行、五粮液、美的、美团、小米、京东、谷歌、亚马逊、Meta 等\n\n### Changed\n- SKILL.md description 优化，新增批量查询、大盘指数等高频搜索关键词\n- SKILL.md tags 从 17 个扩展至 30 个，覆盖更多搜索场景\n- 输出格式新增批量查询的紧凑对比展示格式，涨跌使用 🟢/🔴 颜色标识\n\n## v1.0.4 (2026-02-26)\n\n### Changed\n- SKILL.md 输出格式从 Markdown 表格改为紧凑多行格式，避免飞书消息卡片分页\n- 价格与涨跌幅合并为一行展示\n- 成交量与成交额合并为一行展示\n- 成交额增加人性化单位（亿/万）显示要求\n- README.md 新增最终显示格式示例\n\n## v1.0.3 (2026-02-25)\n\n### Security\n- 新增输入安全校验，stock_code 仅允许字母和数字（`^[A-Za-z0-9]{1,10}$`），market 使用白名单（sh/sz/hk/us），防止 shell 命令注入\n- SKILL.md 增加输入安全校验说明\n- 解决 ClawHub VirusTotal 扫描报告中的 Suspicious 标记\n\n## v1.0.2 (2026-02-24)\n\n### Reverted\n- 移除 stock_query.sh wrapper 脚本，保持纯 .py 脚本方案\n- SKILL.md 调用方式还原为直接 python3 调用\n\n## v1.0.1 (2026-02-24)\n\n### Changed\n- 数据源从新浪财经 API (hq.sinajs.cn) 切换为腾讯财经 API (qt.gtimg.cn)，解决 403 Forbidden 问题\n- 腾讯 API 无需 Referer Header，稳定性更好\n- 统一了各市场（A 股/港股/美股）的数据解析逻辑，代码更简洁\n- 更新 references/api-docs.md 为腾讯 API 文档\n\n## v1.0.0 (2026-02-24)\n\n### Added\n- 初版发布，支持查询股票实时价格\n- 支持 A 股沪市（sh）、A 股深市（sz）、港股（hk）、美股（us）四个市场\n- 自动识别股票代码所属市场\n- 零外部依赖，纯 Python 标准库实现\n- 返回结构化 JSON 数据（当前价、涨跌幅、开高低收、成交量等）\n- API 限流自动重试机制\n- 提供 API 参考文档（references/api-docs.md）\n- SKILL.md 元数据格式对齐 OpenClaw 官方示例规范\n\nArchive v1.1.4: 6 files, 14391 bytes\n\nFiles: CHANGELOG.md (3602b), README.md (3713b), references/api-docs.md (2361b), scripts/stock_query.py (13340b), SKILL.md (8373b), _meta.json (136b)\n\nFile v1.1.4:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"实时股票行情查询，支持 A 股、港股、美股及大盘指数，支持批量查询。无需 API Key。Real-time stock & index quotes for A-shares, HK & US markets. Batch supported.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n        \"tags\": [\"stock\", \"stock-price\", \"A-shares\", \"Hong-Kong\", \"US-stocks\", \"finance\", \"market-index\", \"股票\", \"港股\", \"美股\"],\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象（`pe_ratio` 和 `market_cap` 在数据源可用时返回）：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"pe_ratio\": 28.35,\n  \"market_cap\": 2120000000000.00,\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n📐 市盈率：{pe_ratio} | 总市值：{market_cap}（如有）\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.1.4:README.md\n\n# 📈 stock-price-query\n\nAn [OpenClaw](https://github.com/openclaw/openclaw) skill for querying real-time stock prices across multiple markets.\n\n## Features\n\n- **Multi-market support**: A-shares (Shanghai & Shenzhen), Hong Kong stocks, and US stocks\n- **Auto market detection**: Automatically identifies the market based on stock code format\n- **Zero dependencies**: Pure Python 3 standard library, no external packages required\n- **Structured output**: Returns JSON with price, change, volume, and more\n\n## Supported Markets\n\n| Market | Code Format | Example |\n|--------|------------|---------|\n| Shanghai (SH) | 6-digit starting with 6 | `600519` (Kweichow Moutai) |\n| Shenzhen (SZ) | 6-digit starting with 0/3 | `300750` (CATL) |\n| Hong Kong (HK) | Up to 5 digits, or index code | `00700` (Tencent), `HSI` (Hang Seng Index) |\n| US | Alphabetic ticker, or `.`-prefixed index | `AAPL` (Apple), `.IXIC` (NASDAQ) |\n\n### Market Indices\n\n| Index | Code | Market |\n|-------|------|--------|\n| SSE Composite (上证指数) | `000001` | sh |\n| SZSE Component (深证成指) | `399001` | sz |\n| ChiNext (创业板指) | `399006` | sz |\n| Hang Seng Index (恒生指数) | `HSI` | hk |\n| HSCEI (国企指数) | `HSCEI` | hk |\n| NASDAQ Composite (纳斯达克) | `.IXIC` | us |\n| Dow Jones (道琼斯) | `.DJI` | us |\n| S&P 500 (标普500) | `.INX` | us |\n\n## Usage\n\n### As an OpenClaw Skill\n\nCopy this repository to your OpenClaw skills directory:\n\n```bash\n# User-level\ncp -r stock-price-query ~/.openclaw/skills/\n\n# Or project-level\ncp -r stock-price-query /path/to/project/skills/\n```\n\nThen ask naturally in OpenClaw:\n\n- \"What's the current price of AAPL?\"\n- \"查一下贵州茅台的股价\"\n- \"How is Tencent doing today?\"\n\n### Standalone\n\n```bash\npython3 scripts/stock_query.py <stock_code> [market]\n\n# Examples — Individual stocks\npython3 scripts/stock_query.py 600519        # A-share (auto-detect)\npython3 scripts/stock_query.py AAPL          # US stock\npython3 scripts/stock_query.py 00700 hk      # Hong Kong stock\n\n# Examples — Market indices\npython3 scripts/stock_query.py 000001 sh     # SSE Composite (上证指数)\npython3 scripts/stock_query.py HSI           # Hang Seng Index (恒生指数)\npython3 scripts/stock_query.py .IXIC         # NASDAQ Composite (纳斯达克)\npython3 scripts/stock_query.py .DJI          # Dow Jones (道琼斯)\n\n# Examples — Batch query (mixed stocks & indices)\npython3 scripts/stock_query.py .IXIC,HSI,600519,AAPL\n```\n\n### Output Example\n\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1466.80,\n  \"change\": -18.50,\n  \"change_percent\": -1.25,\n  \"open\": 1521.00,\n  \"high\": 1524.40,\n  \"low\": 1463.60,\n  \"prev_close\": 1485.30,\n  \"volume\": 4191300,\n  \"amount\": 6198840000.00,\n  \"time\": \"20260224161416\",\n  \"status\": \"success\"\n}\n```\n\n### Display Example (via OpenClaw + Feishu)\n\nWhen queried through OpenClaw in Feishu, the result is displayed in a compact format:\n\n```\n📈 贵州茅台（600519.sh）\n\n💰 当前价格：1466.80 元 | 📊 涨跌幅：-18.50 (-1.25%) ↓\n📅 行情时间：2026/02/24 16:14:16\n📊 今开 1521.00 | 最高 1524.40 | 最低 1463.60 | 昨收 1485.30\n📦 成交量：4,191,300 | 成交额：61.99亿\n```\n\n## Project Structure\n\n```\nstock-price-query/\n├── SKILL.md              # OpenClaw skill definition\n├── CHANGELOG.md          # Version history\n├── README.md             # This file\n├── scripts/\n│   └── stock_query.py    # Query script (Python 3)\n└── references/\n    └── api-docs.md       # API documentation\n```\n\n## Data Source\n\nUses Tencent Finance API (`qt.gtimg.cn`) — free, no API key required, no special headers needed.\n\n## License\n\nMIT\n\nFile v1.1.4:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.1.4\",\n  \"publishedAt\": 1774771361261\n}\n\nFile v1.1.4:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nFile v1.1.4:CHANGELOG.md\n\n# Changelog\n\n## v1.1.4 (2026-03-29)\n\n### Added\n- **市盈率与市值数据**：查询结果新增 `pe_ratio`（市盈率）和 `market_cap`（总市值）字段，在数据源可用时自动返回\n- **版本号查询**：支持 `--version` / `-V` 参数查看脚本版本\n\n### Changed\n- SKILL.md 输出格式说明新增市盈率和市值展示\n- 恢复 CHANGELOG.md 和 README.md 文档\n\n## v1.1.3 (2026-03-23)\n\n### Changed\n- Removed documentation files: CHANGELOG.md and README.md\n\n## v1.1.2 (2026-03-23)\n\n### Changed\n- Minor metadata updates\n\n## v1.1.1 (2026-03-23)\n\n### Fixed\n- **美股指数代码支持**：修复 `.IXIC`（纳斯达克）、`.DJI`（道琼斯）、`.INX`（标普500）等以 `.` 开头的指数代码被输入校验正则拦截的问题，正则从 `^[A-Za-z0-9]{1,10}$` 改为 `^\\.?[A-Za-z0-9]{1,10}$`\n- **港股指数市场识别**：`HSI`（恒生指数）、`HSCEI`（国企指数）等纯字母港股指数代码之前被 `detect_market` 误判为美股，新增 `HK_INDEX_CODES` 白名单优先匹配港股指数\n- **港股指数代码格式**：`build_tencent_symbol` 和 `parse_stock` 中港股指数不再做 `zfill(5)` 补零，避免生成无效代码如 `0HSI`\n\n## v1.1.0 (2026-03-23)\n\n### Added\n- **批量查询**：支持一次查询多只股票（逗号分隔），单次 HTTP 请求获取全部数据，最多 20 只\n- **大盘指数映射**：新增上证指数、深证成指、创业板指、恒生指数、纳斯达克、道琼斯、标普500 等指数代码映射\n- **扩大股票映射表**：从 10 只扩展至 21 只热门个股，新增招商银行、工商银行、五粮液、美的、美团、小米、京东、谷歌、亚马逊、Meta 等\n\n### Changed\n- SKILL.md description 优化，新增批量查询、大盘指数等高频搜索关键词\n- SKILL.md tags 从 17 个扩展至 30 个，覆盖更多搜索场景\n- 输出格式新增批量查询的紧凑对比展示格式，涨跌使用 🟢/🔴 颜色标识\n\n## v1.0.4 (2026-02-26)\n\n### Changed\n- SKILL.md 输出格式从 Markdown 表格改为紧凑多行格式，避免飞书消息卡片分页\n- 价格与涨跌幅合并为一行展示\n- 成交量与成交额合并为一行展示\n- 成交额增加人性化单位（亿/万）显示要求\n- README.md 新增最终显示格式示例\n\n## v1.0.3 (2026-02-25)\n\n### Security\n- 新增输入安全校验，stock_code 仅允许字母和数字（`^[A-Za-z0-9]{1,10}$`），market 使用白名单（sh/sz/hk/us），防止 shell 命令注入\n- SKILL.md 增加输入安全校验说明\n- 解决 ClawHub VirusTotal 扫描报告中的 Suspicious 标记\n\n## v1.0.2 (2026-02-24)\n\n### Reverted\n- 移除 stock_query.sh wrapper 脚本，保持纯 .py 脚本方案\n- SKILL.md 调用方式还原为直接 python3 调用\n\n## v1.0.1 (2026-02-24)\n\n### Changed\n- 数据源从新浪财经 API (hq.sinajs.cn) 切换为腾讯财经 API (qt.gtimg.cn)，解决 403 Forbidden 问题\n- 腾讯 API 无需 Referer Header，稳定性更好\n- 统一了各市场（A 股/港股/美股）的数据解析逻辑，代码更简洁\n- 更新 references/api-docs.md 为腾讯 API 文档\n\n## v1.0.0 (2026-02-24)\n\n### Added\n- 初版发布，支持查询股票实时价格\n- 支持 A 股沪市（sh）、A 股深市（sz）、港股（hk）、美股（us）四个市场\n- 自动识别股票代码所属市场\n- 零外部依赖，纯 Python 标准库实现\n- 返回结构化 JSON 数据（当前价、涨跌幅、开高低收、成交量等）\n- API 限流自动重试机制\n- 提供 API 参考文档（references/api-docs.md）\n- SKILL.md 元数据格式对齐 OpenClaw 官方示例规范\n\nArchive v1.1.3: 4 files, 9892 bytes\n\nFiles: references/api-docs.md (2361b), scripts/stock_query.py (12575b), SKILL.md (8190b), _meta.json (136b)\n\nFile v1.1.3:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"实时股票行情查询，支持 A 股、港股、美股及大盘指数，支持批量查询。无需 API Key。Real-time stock & index quotes for A-shares, HK & US markets. Batch supported.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n        \"tags\": [\"stock\", \"stock-price\", \"A-shares\", \"Hong-Kong\", \"US-stocks\", \"finance\", \"market-index\", \"股票\", \"港股\", \"美股\"],\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.1.3:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.1.3\",\n  \"publishedAt\": 1774499073120\n}\n\nFile v1.1.3:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nArchive v1.1.2: 6 files, 13811 bytes\n\nFiles: CHANGELOG.md (3068b), README.md (3713b), references/api-docs.md (2361b), scripts/stock_query.py (12575b), SKILL.md (8190b), _meta.json (136b)\n\nFile v1.1.2:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"实时股票行情查询，支持 A 股、港股、美股及大盘指数，支持批量查询。无需 API Key。Real-time stock & index quotes for A-shares, HK & US markets. Batch supported.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n        \"tags\": [\"stock\", \"stock-price\", \"A-shares\", \"Hong-Kong\", \"US-stocks\", \"finance\", \"market-index\", \"股票\", \"港股\", \"美股\"],\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.1.2:README.md\n\n# 📈 stock-price-query\n\nAn [OpenClaw](https://github.com/openclaw/openclaw) skill for querying real-time stock prices across multiple markets.\n\n## Features\n\n- **Multi-market support**: A-shares (Shanghai & Shenzhen), Hong Kong stocks, and US stocks\n- **Auto market detection**: Automatically identifies the market based on stock code format\n- **Zero dependencies**: Pure Python 3 standard library, no external packages required\n- **Structured output**: Returns JSON with price, change, volume, and more\n\n## Supported Markets\n\n| Market | Code Format | Example |\n|--------|------------|---------|\n| Shanghai (SH) | 6-digit starting with 6 | `600519` (Kweichow Moutai) |\n| Shenzhen (SZ) | 6-digit starting with 0/3 | `300750` (CATL) |\n| Hong Kong (HK) | Up to 5 digits, or index code | `00700` (Tencent), `HSI` (Hang Seng Index) |\n| US | Alphabetic ticker, or `.`-prefixed index | `AAPL` (Apple), `.IXIC` (NASDAQ) |\n\n### Market Indices\n\n| Index | Code | Market |\n|-------|------|--------|\n| SSE Composite (上证指数) | `000001` | sh |\n| SZSE Component (深证成指) | `399001` | sz |\n| ChiNext (创业板指) | `399006` | sz |\n| Hang Seng Index (恒生指数) | `HSI` | hk |\n| HSCEI (国企指数) | `HSCEI` | hk |\n| NASDAQ Composite (纳斯达克) | `.IXIC` | us |\n| Dow Jones (道琼斯) | `.DJI` | us |\n| S&P 500 (标普500) | `.INX` | us |\n\n## Usage\n\n### As an OpenClaw Skill\n\nCopy this repository to your OpenClaw skills directory:\n\n```bash\n# User-level\ncp -r stock-price-query ~/.openclaw/skills/\n\n# Or project-level\ncp -r stock-price-query /path/to/project/skills/\n```\n\nThen ask naturally in OpenClaw:\n\n- \"What's the current price of AAPL?\"\n- \"查一下贵州茅台的股价\"\n- \"How is Tencent doing today?\"\n\n### Standalone\n\n```bash\npython3 scripts/stock_query.py <stock_code> [market]\n\n# Examples — Individual stocks\npython3 scripts/stock_query.py 600519        # A-share (auto-detect)\npython3 scripts/stock_query.py AAPL          # US stock\npython3 scripts/stock_query.py 00700 hk      # Hong Kong stock\n\n# Examples — Market indices\npython3 scripts/stock_query.py 000001 sh     # SSE Composite (上证指数)\npython3 scripts/stock_query.py HSI           # Hang Seng Index (恒生指数)\npython3 scripts/stock_query.py .IXIC         # NASDAQ Composite (纳斯达克)\npython3 scripts/stock_query.py .DJI          # Dow Jones (道琼斯)\n\n# Examples — Batch query (mixed stocks & indices)\npython3 scripts/stock_query.py .IXIC,HSI,600519,AAPL\n```\n\n### Output Example\n\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1466.80,\n  \"change\": -18.50,\n  \"change_percent\": -1.25,\n  \"open\": 1521.00,\n  \"high\": 1524.40,\n  \"low\": 1463.60,\n  \"prev_close\": 1485.30,\n  \"volume\": 4191300,\n  \"amount\": 6198840000.00,\n  \"time\": \"20260224161416\",\n  \"status\": \"success\"\n}\n```\n\n### Display Example (via OpenClaw + Feishu)\n\nWhen queried through OpenClaw in Feishu, the result is displayed in a compact format:\n\n```\n📈 贵州茅台（600519.sh）\n\n💰 当前价格：1466.80 元 | 📊 涨跌幅：-18.50 (-1.25%) ↓\n📅 行情时间：2026/02/24 16:14:16\n📊 今开 1521.00 | 最高 1524.40 | 最低 1463.60 | 昨收 1485.30\n📦 成交量：4,191,300 | 成交额：61.99亿\n```\n\n## Project Structure\n\n```\nstock-price-query/\n├── SKILL.md              # OpenClaw skill definition\n├── CHANGELOG.md          # Version history\n├── README.md             # This file\n├── scripts/\n│   └── stock_query.py    # Query script (Python 3)\n└── references/\n    └── api-docs.md       # API documentation\n```\n\n## Data Source\n\nUses Tencent Finance API (`qt.gtimg.cn`) — free, no API key required, no special headers needed.\n\n## License\n\nMIT\n\nFile v1.1.2:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.1.2\",\n  \"publishedAt\": 1774312671290\n}\n\nFile v1.1.2:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nFile v1.1.2:CHANGELOG.md\n\n# Changelog\n\n## v1.1.1 (2026-03-23)\n\n### Fixed\n- **美股指数代码支持**：修复 `.IXIC`（纳斯达克）、`.DJI`（道琼斯）、`.INX`（标普500）等以 `.` 开头的指数代码被输入校验正则拦截的问题，正则从 `^[A-Za-z0-9]{1,10}$` 改为 `^\\.?[A-Za-z0-9]{1,10}$`\n- **港股指数市场识别**：`HSI`（恒生指数）、`HSCEI`（国企指数）等纯字母港股指数代码之前被 `detect_market` 误判为美股，新增 `HK_INDEX_CODES` 白名单优先匹配港股指数\n- **港股指数代码格式**：`build_tencent_symbol` 和 `parse_stock` 中港股指数不再做 `zfill(5)` 补零，避免生成无效代码如 `0HSI`\n\n## v1.1.0 (2026-03-23)\n\n### Added\n- **批量查询**：支持一次查询多只股票（逗号分隔），单次 HTTP 请求获取全部数据，最多 20 只\n- **大盘指数映射**：新增上证指数、深证成指、创业板指、恒生指数、纳斯达克、道琼斯、标普500 等指数代码映射\n- **扩大股票映射表**：从 10 只扩展至 21 只热门个股，新增招商银行、工商银行、五粮液、美的、美团、小米、京东、谷歌、亚马逊、Meta 等\n\n### Changed\n- SKILL.md description 优化，新增批量查询、大盘指数等高频搜索关键词\n- SKILL.md tags 从 17 个扩展至 30 个，覆盖更多搜索场景\n- 输出格式新增批量查询的紧凑对比展示格式，涨跌使用 🟢/🔴 颜色标识\n\n## v1.0.4 (2026-02-26)\n\n### Changed\n- SKILL.md 输出格式从 Markdown 表格改为紧凑多行格式，避免飞书消息卡片分页\n- 价格与涨跌幅合并为一行展示\n- 成交量与成交额合并为一行展示\n- 成交额增加人性化单位（亿/万）显示要求\n- README.md 新增最终显示格式示例\n\n## v1.0.3 (2026-02-25)\n\n### Security\n- 新增输入安全校验，stock_code 仅允许字母和数字（`^[A-Za-z0-9]{1,10}$`），market 使用白名单（sh/sz/hk/us），防止 shell 命令注入\n- SKILL.md 增加输入安全校验说明\n- 解决 ClawHub VirusTotal 扫描报告中的 Suspicious 标记\n\n## v1.0.2 (2026-02-24)\n\n### Reverted\n- 移除 stock_query.sh wrapper 脚本，保持纯 .py 脚本方案\n- SKILL.md 调用方式还原为直接 python3 调用\n\n## v1.0.1 (2026-02-24)\n\n### Changed\n- 数据源从新浪财经 API (hq.sinajs.cn) 切换为腾讯财经 API (qt.gtimg.cn)，解决 403 Forbidden 问题\n- 腾讯 API 无需 Referer Header，稳定性更好\n- 统一了各市场（A 股/港股/美股）的数据解析逻辑，代码更简洁\n- 更新 references/api-docs.md 为腾讯 API 文档\n\n## v1.0.0 (2026-02-24)\n\n### Added\n- 初版发布，支持查询股票实时价格\n- 支持 A 股沪市（sh）、A 股深市（sz）、港股（hk）、美股（us）四个市场\n- 自动识别股票代码所属市场\n- 零外部依赖，纯 Python 标准库实现\n- 返回结构化 JSON 数据（当前价、涨跌幅、开高低收、成交量等）\n- API 限流自动重试机制\n- 提供 API 参考文档（references/api-docs.md）\n- SKILL.md 元数据格式对齐 OpenClaw 官方示例规范\n\nArchive v1.1.1: 4 files, 10014 bytes\n\nFiles: references/api-docs.md (2361b), scripts/stock_query.py (12575b), SKILL.md (8463b), _meta.json (136b)\n\nFile v1.1.1:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"实时股票行情查询，支持 A 股、港股、美股及大盘指数，支持批量查询。无需 API Key。Real-time stock & index quotes for A-shares, HK & US markets. Batch supported.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n        \"tags\": [\"stock\", \"stock-price\", \"quote\", \"A-shares\", \"Hong-Kong\", \"US-stocks\", \"finance\", \"market-data\", \"real-time\", \"equity\", \"ticker\", \"行情\", \"股票\", \"股价\", \"美股\", \"港股\", \"A股\", \"batch-query\", \"index\", \"大盘\", \"指数\", \"涨跌\", \"trading\", \"investing\", \"portfolio\", \"watchlist\", \"market-index\", \"shanghai\", \"shenzhen\", \"nasdaq\", \"hang-seng\", \"批量查询\", \"K线\", \"成交量\"],\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n**大盘指数：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 上证指数/大盘 | 000001 | sh |\n| 深证成指 | 399001 | sz |\n| 创业板指 | 399006 | sz |\n| 恒生指数/恒指 | HSI | hk |\n| 国企指数/H股指数 | HSCEI | hk |\n| 纳斯达克/纳指 | .IXIC | us |\n| 道琼斯/道指 | .DJI | us |\n| 标普500 | .INX | us |\n\n**热门个股：**\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 招商银行 | 600036 | sh |\n| 工商银行 | 601398 | sh |\n| 中国石油 | 601857 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 五粮液 | 000858 | sz |\n| 美的集团 | 000333 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 美团 | 03690 | hk |\n| 小米集团 | 01810 | hk |\n| 京东 | 09618 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n| 谷歌/Google | GOOGL | us |\n| 亚马逊/Amazon | AMZN | us |\n| Meta/Facebook | META | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n**单只查询**：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n```\n\n**批量查询**：多只股票依次展示，每只之间空一行：\n\n```\n📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓\n```\n\n涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母、数字和前导点号（正则 `^\\.?[A-Za-z0-9]{1,10}$`，前导点号用于支持美股指数代码如 `.IXIC`、`.DJI`、`.INX`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **批量查询数量限制**：一次最多查询 20 只股票，超出时返回错误提示。\n- **批量查询部分失败**：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.1.1\",\n  \"publishedAt\": 1774310517422\n}\n\nFile v1.1.1:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nArchive v1.0.7: 4 files, 7513 bytes\n\nFiles: references/api-docs.md (2108b), scripts/stock_query.py (7444b), SKILL.md (5669b), _meta.json (136b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"实时股票行情查询工具，支持 A 股（沪深两市）、港股、美股，无需 API Key。当用户查询股价、行情、涨跌，或提到股票代码/名称（如 600519、00700、NVDA、茅台、腾讯）时触发。Real-time stock price query for A-shares, HK & US stocks. Triggered when users ask about stock prices, quotes, or mention ticker symbols.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n        \"tags\": [\"stock\", \"stock-price\", \"quote\", \"A-shares\", \"Hong-Kong\", \"US-stocks\", \"finance\", \"market-data\", \"real-time\", \"equity\", \"ticker\", \"行情\", \"股票\", \"股价\", \"美股\", \"港股\", \"A股\"],\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote tool covering A-shares, Hong Kong, and US stocks. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。\n\n**输出格式**：JSON，包含以下字段：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"status\": \"success\"\n}\n```\n\n### 常见股票名称与代码映射（供 agent 参考）\n\n脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n```\n\n涨跌幅为正时使用 ↑，为负时使用 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母和数字（正则 `^[A-Za-z0-9]{1,10}$`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1773326920974\n}\n\nFile v1.0.7:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。\n\nArchive v1.0.6: 4 files, 7408 bytes\n\nFiles: references/api-docs.md (2108b), scripts/stock_query.py (7444b), SKILL.md (5353b), _meta.json (136b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: stock-price-query\ndescription: \"实时股票行情查询工具，支持 A 股（沪深两市）、港股、美股，无需 API Key。当用户查询股价、行情、涨跌，或提到股票代码/名称（如 600519、00700、NVDA、茅台、腾讯）时触发。Real-time stock price query for A-shares, HK & US stocks. Triggered when users ask about stock prices, quotes, or mention ticker symbols.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"📈\",\n        \"requires\": { \"bins\": [\"python3\"] },\n        \"tags\": [\"stock\", \"stock-price\", \"quote\", \"A-shares\", \"Hong-Kong\", \"US-stocks\", \"finance\", \"market-data\", \"real-time\", \"equity\", \"ticker\", \"行情\", \"股票\", \"股价\", \"美股\", \"港股\", \"A股\"],\n      },\n  }\n---\n\n# Stock Price Query Skill\n\n实时股票行情查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote tool covering A-shares, Hong Kong, and US stocks. Quick chat-friendly price checks with zero dependencies and no API key needed.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码或股票名称。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。\n\n**输出格式**：JSON，包含以下字段：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"status\": \"success\"\n}\n```\n\n### 常见股票名称与代码映射\n\n如果用户提供的是股票名称而非代码，先尝试匹配常见股票：\n\n| 名称 | 代码 | 市场 |\n|------|------|------|\n| 贵州茅台 | 600519 | sh |\n| 中国平安 | 601318 | sh |\n| 比亚迪 | 002594 | sz |\n| 宁德时代 | 300750 | sz |\n| 腾讯控股 | 00700 | hk |\n| 阿里巴巴 | 09988 | hk |\n| 苹果/Apple | AAPL | us |\n| 特斯拉/Tesla | TSLA | us |\n| 英伟达/NVIDIA | NVDA | us |\n| 微软/Microsoft | MSFT | us |\n\n对于不在映射表中的股票名称，提示用户提供准确的股票代码。\n\n### 输出格式要求\n\n查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：\n\n```\n📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n```\n\n涨跌幅为正时使用 ↑，为负时使用 ↓。成交额如果超过 1 亿，用\"亿\"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用\"万\"为单位显示。\n\n## Edge Cases\n\n- **输入安全校验**：脚本在执行前会严格校验所有输入参数。`stock_code` 仅允许字母和数字（正则 `^[A-Za-z0-9]{1,10}$`），`market` 仅允许白名单值（`sh`/`sz`/`hk`/`us`）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。\n- **股票代码无效**：返回 \"无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。\"\n- **网络请求失败**：返回 \"网络请求失败，请稍后重试。\"\n- **非交易时段**：正常返回最近的收盘数据，并提示 \"当前为非交易时段，显示的是最近一次的收盘数据。\"\n- **股票名称模糊**：提示用户提供准确的股票代码以确保查询准确性。\n- **API 限流**：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1773326599327\n}\n\nFile v1.0.6:references/api-docs.md\n\n# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，无需 API Key，无需特殊 Header。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。","readmeExcerpt":"Skill: 股票查询 / Stock Price Query Owner: tjefferson Summary: 股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query fo... Tags: latest:1.2.1 Version history: v1.2.1 | 2026-04-19T04:27:11.732Z | user 规避 ClawHub 安全扫描器对 'API Key' 关键词的误判（skill 实际无需任何凭证）；新增数据实时性说明段落 v1.2.0 | 2026-04-19T03:22:43.675Z | user 优化 ClawHub 改版后的搜索可发","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]"},{"language":"bash","snippet":"python3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>"},{"language":"json","snippet":"{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"pe_ratio\": 28.35,\n  \"market_cap\": 2120000000000.00,\n  \"status\": \"success\"\n}"},{"language":"json","snippet":"[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"name\": \"APPLE\", \"market\": \"us\", \"current_price\": 178.50, \"change\": -1.30, \"change_percent\": -0.72, \"status\": \"success\", ... }\n]"},{"language":"text","snippet":"📈 **{股票名称}**（{股票代码}.{市场}）\n\n💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓\n📅 行情时间：{time}\n📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}\n📦 成交量：{volume} | 成交额：{amount}\n📐 市盈率：{pe_ratio} | 总市值：{market_cap}（如有）"},{"language":"text","snippet":"📈 **贵州茅台**（600519.SH）\n💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑\n\n📈 **腾讯控股**（00700.HK）\n💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑\n\n📈 **APPLE**（AAPL.US）\n💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: stock-price-query\ndescription: \"股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query for A-shares (Shanghai/Shenzhen), Hong Kong and US stocks. Batch query up to 20 symbols. Zero configuration, ready to use out of the box.\"\ncategory: Data & APIs\nmetadata:\n  openclaw:\n    emoji: \"📈\"\n    requires:\n      bins: [python3]\n---\n\n# Stock Price Query Skill\n\n实时股票行情与大盘指数查询技能，覆盖 **A 股（沪深两市）**、**港股**、**美股**三大市场。支持**单只查询**和**批量查询**（一次查询多只股票对比），轻量无依赖，零配置开箱即用，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。\n\nReal-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and zero configuration.\n\n## Overview\n\n实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情接口获取数据，返回结构化的股票信息。\n\n### 数据实时性说明\n\n- **A 股**：交易时段内**实时行情**（秒级更新）\n- **港股 / 美股**：按境外交易所（HKEX / NYSE / NASDAQ）行情授权规定，免费公开接口为**延迟约 15 分钟行情**。如需港股/美股 Level-1 实时行情，请使用付费持牌渠道\n\n## When to Use\n\n当用户的请求涉及以下场景时触发此技能：\n\n- 查询股价：\"茅台多少钱\"、\"查一下宁德时代\"\n- 了解涨跌：\"腾讯今天涨了吗\"、\"00700 行情\"\n- 股票代码查询：\"600519\"、\"NVDA price\"\n- 多只对比：\"比亚迪和英伟达的股价\"、\"帮我看下茅台、腾讯和苹果\"\n- 批量查询：\"查一下这几只：600519, 00700, AAPL\"\n- 大盘指数：\"上证指数多少\"、\"大盘怎么样\"、\"恒指行情\"\n- 关键词触发：\"查股票\"、\"股票行情\"、\"stock price\"\n\n## How to Use\n\n### 查询流程\n\n1. **解析用户输入**：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。\n2. **识别市场**：根据股票代码格式自动识别所属市场：\n   - A 股沪市：以 `sh` 开头或 6 位数字以 6 开头（如 `sh600519`、`600519`）\n   - A 股深市：以 `sz` 开头或 6 位数字以 0/3 开头（如 `sz000001`、`300750`）\n   - 港股：以 `hk` 开头或纯数字 5 位及以下（如 `hk00700`、`00700`），港股指数为纯字母代码（如 `HSI`、`HSCEI`）\n   - 美股：纯英文字母代码（如 `AAPL`、`TSLA`、`GOOGL`），美股指数以 `.` 开头（如 `.IXIC`、`.DJI`、`.INX`）\n3. **执行查询脚本**：运行 `scripts/stock_query.py` 获取实时数据。\n4. **格式化输出**：将结果以清晰友好的格式展示给用户。\n\n### 脚本调用方式\n\n**单只查询：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]\n```\n\n**批量查询（推荐用于多只对比）：**\n```bash\npython3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>\n```\n\n**参数说明：**\n- `stock_code`（必需）：股票代码，如 `600519`、`AAPL`、`00700`。批量查询时用逗号分隔，最多 20 只。\n- `market`（可选）：市场标识，可选值为 `sh`（沪市）、`sz`（深市）、`hk`（港股）、`us`（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。\n\n**单只查询输出格式**：JSON 对象（`pe_ratio` 和 `market_cap` 在数据源可用时返回）：\n```json\n{\n  \"code\": \"600519\",\n  \"name\": \"贵州茅台\",\n  \"market\": \"sh\",\n  \"current_price\": 1688.00,\n  \"change\": 12.50,\n  \"change_percent\": 0.75,\n  \"open\": 1680.00,\n  \"high\": 1695.00,\n  \"low\": 1675.00,\n  \"prev_close\": 1675.50,\n  \"volume\": 2345678,\n  \"amount\": 3956789012.50,\n  \"time\": \"2026-02-24 15:00:00\",\n  \"pe_ratio\": 28.35,\n  \"market_cap\": 2120000000000.00,\n  \"status\": \"success\"\n}\n```\n\n**批量查询输出格式**：JSON 数组，每只股票一个对象：\n```json\n[\n  { \"code\": \"600519\", \"name\": \"贵州茅台\", \"market\": \"sh\", \"current_price\": 1688.00, \"change\": 12.50, \"change_percent\": 0.75, \"status\": \"success\", ... },\n  { \"code\": \"00700\", \"name\": \"腾讯控股\", \"market\": \"hk\", \"current_price\": 420.60, \"change\": 5.20, \"change_percent\": 1.25, \"status\": \"success\", ... },\n  { \"code\": \"AAPL\", \"na"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn72jm08z8zg612dswg2c11sbs80w1w8\",\n  \"slug\": \"stock-price-query\",\n  \"version\": \"1.2.1\",\n  \"publishedAt\": 1776572831732\n}"},{"path":"references/api-docs.md","content":"# 股票查询 API 参考文档\n\n## 数据源：腾讯财经实时行情 API\n\n本技能使用腾讯财经免费公开的 HTTP 接口获取实时股票行情数据，直接调用公开接口，无需任何配置。\n\n### 接口地址\n\n```\nhttps://qt.gtimg.cn/q={symbol}\n```\n\n### 请求要求\n\n- **Method**: GET\n- **编码**: GBK（响应需用 GBK 解码）\n- **无需特殊 Header**，直接请求即可\n\n### 股票代码格式\n\n| 市场 | 前缀 | 示例 | 说明 |\n|------|------|------|------|\n| 沪市 A 股 | `sh` | `sh600519` | 上海证券交易所 |\n| 深市 A 股 | `sz` | `sz300750` | 深圳证券交易所 |\n| 港股 | `hk` | `hk00700` | 香港联交所，个股代码 5 位数字 |\n| 港股指数 | `hk` | `hkHSI`、`hkHSCEI` | 恒生指数、国企指数等，纯字母代码不补零 |\n| 美股 | `us` | `usAAPL` | 纽约/纳斯达克 |\n| 美股指数 | `us` | `us.IXIC`、`us.DJI`、`us.INX` | 纳斯达克、道琼斯、标普500，代码以 `.` 开头 |\n\n### 批量查询\n\n支持一次查询多只股票，用逗号分隔：\n```\nhttps://qt.gtimg.cn/q=sh600519,sz300750,hk00700\n```\n\n### 返回数据格式\n\n返回一行文本，字段以 `~` 分隔（各市场格式统一）。\n\n#### 通用字段索引\n\n| 索引 | 含义 | 说明 |\n|------|------|------|\n| [1]  | 股票名称 | 中文名称 |\n| [2]  | 股票代码 | |\n| [3]  | 当前价格 | |\n| [4]  | 昨收盘价 | |\n| [5]  | 今日开盘价 | |\n| [6]  | 成交量 | A 股单位为手（1手=100股），港股/美股为股 |\n| [30] | 行情时间 | 格式因市场而异 |\n| [31] | 涨跌额 | |\n| [32] | 涨跌幅(%) | |\n| [33] | 最高价 | |\n| [34] | 最低价 | |\n| [37] | 成交额 | A 股单位为万元，港股/美股为当地货币 |\n\n### 注意事项\n\n1. **频率限制**：接口免费，但高频访问可能触发限流（HTTP 429），建议间隔 1 秒以上。\n2. **交易时段**：\n   - A 股：工作日 9:30-11:30, 13:00-15:00（北京时间）\n   - 港股：工作日 9:30-12:00, 13:00-16:00（香港时间）\n   - 美股：工作日 9:30-16:00（美东时间），即北京时间 22:30-5:00（夏令时 21:30-4:00）\n3. **非交易时段**：返回最近一次交易的收盘数据。\n4. **编码**：响应为 GBK 编码，解析时需用 `gbk` 解码。\n5. **与新浪 API 的区别**：腾讯 API 无需设置 Referer Header，不会出现 403 问题，稳定性更好。"},{"path":"skill-card.md","content":"## Description:\n\nQueries current stock quotes and market index data for A-shares, Hong Kong stocks, US stocks, and major indexes, with single-symbol and batch lookup support.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[tjefferson](https://clawhub.ai/user/tjefferson)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to look up stock symbols or common mapped stock names and return compact quote summaries for A-share, Hong Kong, US equities, and major market indexes.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Queried stock symbols are sent to Tencent's public quote API.\n\nMitigation: Use the skill only when this third-party market-data request is acceptable, and avoid submitting symbols whose disclosure would be sensitive.\n\nRisk: Hong Kong and US market data from the free public endpoint may be delayed, and non-trading periods may return recent close data.\n\nMitigation: Treat results as informational market data and verify time-sensitive or regulated decisions with an authorized market-data source.\n\nRisk: The public endpoint may rate limit or fail due to network availability.\n\nMitigation: Use light retry behavior and clearly report unavailable or partial results rather than presenting missing data as current.\n\n## Reference(s):\n\n- [股票查询 API 参考文档](references/api-docs.md)\n- [Tencent public quote API endpoint](https://qt.gtimg.cn/q={symbol})\n- [ClawHub skill page](https://clawhub.ai/tjefferson/skills/stock-price-query)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, JSON, guidance]\n\n**Output Format:** [JSON from the query script and concise Markdown quote summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Supports single-symbol lookup or comma-separated batches up to 20 symbols; requires python3 and network access to Tencent's public quote API.]\n\n## Skill Version(s):\n\n1.2.1 (source: ClawHub release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query fo... Skill: 股票查询 / Stock Price Query Owner: tjefferson Summary: 股票查询 / Stock price query. 实时查询股票、股价、行情数据，支持 A 股（沪深）、港股、美股及大盘指数（上证、深证、恒生、纳斯达克、道琼斯、标普500），支持批量查询，零配置开箱即用。Real-time stock price, quote and market index query fo... Tags: latest:1.2.1 Version history: v1.2.1 | 2026-04-19T04:27:11.732Z | user 规避 ClawHub 安全扫描器对 'API Key' 关键词的误判（skill 实际无需任何凭证）；新增数据实时性说明段落 v1.2.0 | 2026-04-19T03:22:43.675Z | user 优化 ClawHub 改版后的搜索可发","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":973,"uniquenessScore":55,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:35:02.277Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:35:02.277Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:32:40.803Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}