{"id":"5c46e628-e292-4f16-80c0-c86daac693cd","entityType":"agent","slug":"clawhub-upkuajing-global-company-shareholder","name":"Conduct global company-level lookup to retrieve shareholders, C-suite executives and multi-tier equity structure data from worldwide corporate databases.Generate full shareholder rosters including ownership ratios, share classes and hierarchical ownership","canonicalUrl":"https://www.xpersona.co/agent/clawhub-upkuajing-global-company-shareholder","canonicalPath":"/agent/clawhub-upkuajing-global-company-shareholder","generatedAt":"2026-10-11T07:43:31.715Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:54:47.170Z","emptyReason":null},"description":"Retrieve overseas shareholders, executives and ultimate beneficial owners by company ID. Analyze equity structure for due‑diligence, investment research and competitor background checks. Trigger: ultimate beneficial owner check, corporate equity structure lookup, overseas shareholder research, company due‑diligence, related‑party transaction screening, identify actual company controllers","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:global-company-shareholder","sourceUrl":"https://clawhub.ai/upkuajing/global-company-shareholder","homepage":"https://clawhub.ai/upkuajing/skills/global-company-shareholder","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/upkuajing/global-company-shareholder","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/upkuajing/skills/global-company-shareholder","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Conduct global company-level lookup to retrieve shareholders, C-suite executives and multi-tier equity structure data from worldwide corporate databases.Generat"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:54:47.170Z","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-11T04:54:47.170Z","emptyReason":null},"stars":null,"forks":null,"downloads":1154,"packageName":null,"latestVersion":"1.0.4","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:54:47.156Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T04:54:47.170Z","lastCrawledAt":"2026-10-11T04:54:47.156Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T04:54:47.156Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.4","createdAt":"2026-08-24T09:15:45.783Z","changelog":"updated","fileCount":11,"zipByteSize":18342},{"version":"1.0.3","createdAt":"2026-07-16T09:00:32.234Z","changelog":"updated","fileCount":9,"zipByteSize":15424},{"version":"1.0.2","createdAt":"2026-07-16T06:24:21.842Z","changelog":"updated","fileCount":9,"zipByteSize":15567},{"version":"1.0.1","createdAt":"2026-07-10T09:47:32.732Z","changelog":"updated","fileCount":9,"zipByteSize":15226},{"version":"1.0.0","createdAt":"2026-07-09T12:24:07.012Z","changelog":"updated","fileCount":9,"zipByteSize":15291}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:global-company-shareholder","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:global-company-shareholder` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/upkuajing/global-company-shareholder before using production credentials."],"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-upkuajing-global-company-shareholder/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/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-11T07:43:31.713Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/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":"medium","updatedAt":"2026-10-11T04:54:47.170Z","emptyReason":null},"readme":"Skill: Conduct global company-level lookup to retrieve shareholders, C-suite executives and multi-tier equity structure data from worldwide corporate databases.Generate full shareholder rosters including ownership ratios, share classes and hierarchical ownership chains via simple company ID searches.Investors, industryanalysts, sales teams and risk management specialists audit equity frameworks and pinpoint ultimate beneficial owners and actual corporate controllersefficiently.Streamline full corporate due diligence, investment performance analysis, competitor group affiliation research and related-party transactionscreening workflows. Verify target enterprises’ controlling parties and assess overall corporate financial standing for risk assessment and B2B prospecting.\n\nOwner: upkuajing\n\nSummary: Retrieve overseas shareholders, executives and ultimate beneficial owners by company ID. Analyze equity structure for due‑diligence, investment research and competitor background checks. Trigger: ultimate beneficial owner check, corporate equity structure lookup, overseas shareholder research, company due‑diligence, related‑party transaction screening, identify actual company controllers\n\nTags: UBO verification:1.0.4, beneficial-owner:1.0.4, competitor research:1.0.4, equity:1.0.4, equity analysis:1.0.4, latest:1.0.4, ownership:1.0.4, people-data:1.0.4, shareholder:1.0.4\n\nVersion history:\n\nv1.0.4 | 2026-08-24T09:15:45.783Z | user\n\nupdated\n\nv1.0.3 | 2026-07-16T09:00:32.234Z | user\n\nupdated\n\nv1.0.2 | 2026-07-16T06:24:21.842Z | user\n\nupdated\n\nv1.0.1 | 2026-07-10T09:47:32.732Z | user\n\nupdated\n\nv1.0.0 | 2026-07-09T12:24:07.012Z | user\n\nupdated\n\nArchive index:\n\nArchive v1.0.4: 11 files, 18342 bytes\n\nFiles: references/company-shareholder-list-api.md (1017b), references/skill-error-report-api.md (2070b), requirements.txt (14b), scripts/auth.py (5860b), scripts/common.py (14567b), scripts/company_shareholder_list.py (1444b), scripts/error_report.py (1845b), scripts/version_check.py (4933b), skill-card.md (2645b), SKILL.md (8658b), _meta.json (145b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: global-company-shareholder\ndescription: \"Retrieve overseas shareholders, executives and ultimate beneficial owners by company ID. Analyze equity structure for due‑diligence, investment research and competitor background checks.\\n\\nTrigger: ultimate beneficial owner check, corporate equity structure lookup, overseas shareholder research, company due‑diligence, related‑party transaction screening, identify actual company controllers\"\nmetadata: {\"version\":\"1.0.4\",\"homepage\":\"https://www.upkuajing.com\",\"clawdbot\":{\"emoji\":\"🏛️\",\"requires\":{\"bins\":[\"python\"],\"env\":[\"UPKUAJING_API_KEY\"]},\"primaryEnv\":\"UPKUAJING_API_KEY\"}}\n---\n\n# Global Company Shareholder Query\n\nQuery shareholder data from the global company database (全球企业库) using the UpKuaJing Open Platform API.\n\n## Overview\n\nThis skill provides access to shareholder information from UpKuaJing's global company database. Given a company ID (pid), it returns the list of shareholders with their IDs, names, types, shareholding methods, and ratios.\n\n**Prerequisite**: The company ID (pid) is required as input. If the user does not already have a company ID, use the **global-company-search** skill first to search for the target company and obtain its pid, then proceed with this skill.\n\n## Running Scripts\n\n### Environment Setup\n\n1. **Check Python**: `python --version`\n2. **Install dependencies**: `pip install -r requirements.txt`\n\nScript directory: `scripts/*.py`\nRun example: `python scripts/*.py`\n\n**Important**: Always use direct script invocation like `python scripts/company_shareholder_list.py`. **Do NOT use** shell compound commands like `cd scripts && python company_shareholder_list.py`\n\n### Shareholder List Query (`company_shareholder_list.py`)\n- **Return granularity**: Each shareholder as one record\n- **Use cases**: Query shareholders of a specific company\n- **Example**:\n - \"Who are the shareholders of company US_12345?\"\n - \"Get shareholder details for pid US_12345\"\n- **Parameters**: See [Shareholder List API](references/company-shareholder-list-api.md)\n\n## API Key and Top-up\n\nThis skill requires an API key. The API key is stored in the `~/.upkuajing/.env` file:\n```bash\ncat ~/.upkuajing/.env\n```\n**Example file content**:\n```\nUPKUAJING_API_KEY=your_api_key_here\n```\n### **API Key Not Set**\nFirst check if the `~/.upkuajing/.env` file has UPKUAJING_API_KEY;\nIf UPKUAJING_API_KEY is not set, prompt the user to choose:\n1. User has one: User provides it (manually add to ~/.upkuajing/.env file)\n2. User doesn't have one: You can apply using the interface (`auth.py --new_key`), the new key will be automatically saved to ~/.upkuajing/.env\nWait for user selection;\n\n### **Account Top-up**\nWhen API response indicates insufficient balance, explain and guide user to top up:\n1. Create top-up order (`auth.py --new_rec_order`)\n2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;\n\n### **Get Account Information**\nUse this script to get account information for UPKUAJING_API_KEY: `auth.py --account_info`\n\n## API Key and UpKuaJing Account\n- Newly applied API key: Register and login at [UpKuaJing Open Platform](https://developer.upkuajing.com/), then bind account\n\n### **Report Skill Call Errors**\nWhen an API call fails or returns abnormal data (server error, timeout, malformed response, etc.), explain the anomaly to the user in natural language and ask whether to report it to the platform for troubleshooting. Only run the report after user confirmation:\n```bash\npython scripts/error_report.py --params '{\"requestPath\":\"/agent/search/depth_company/company/shareholder/list\",\"requestId\":\"f47ac10b58cc4372a5670e02b2c3d479\",\"context\":\"Shareholder list query failed with a server error\"}'\n```\n- Do not report normal business conditions (insufficient balance, invalid API key, parameter errors) — handle them via their own flows\n- Error reporting does not incur query fees\n- **Parameters**: See [Error Report API](references/skill-error-report-api.md)\n\n## Fees\n\n**All API calls incur fees**, different interfaces have different billing methods.\n\n**Latest pricing**: Users can visit [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)\nOr use: `python scripts/auth.py --price_info` (returns complete pricing for all interfaces)\n\n### Query Billing Rules\n\nBilled by **number of calls**, each call returns shareholder data for one company:\n- Each API call incurs a fee\n- **Before execution:**\n 1. Inform user that this query will incur a fee\n 2. Stop, wait for explicit user confirmation in a separate message, then execute script\n\n### Fee Confirmation Principle\n\n**Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.**\n\n## Workflow\n\n### Decision Guide\n\n| User Intent | Use API |\n|-------------|---------|\n| \"Who are the shareholders of company US_12345?\" | Shareholder List Query |\n| User has a company name but no pid | global-company-search (find the company and get its pid, then use this skill) |\n\n## Usage Examples\n\n### Query Shareholder List\n\n**User request**: \"Who are the shareholders of company US_12345?\"\n```bash\npython scripts/company_shareholder_list.py --pid US_12345\n```\n\n## Error Handling\n\n- **API key invalid/non-existent**: Check `UPKUAJING_API_KEY` in `~/.upkuajing/.env` file\n- **Insufficient balance**: Guide user to top up\n- **Invalid parameters**: **Must first check the corresponding API documentation in references/ directory**, get correct parameter names and formats from documentation, do not guess\n- **Skill call errors / abnormal responses**: Explain to the user and, with user confirmation, report to the platform via `python scripts/error_report.py` (see [Report Skill Call Errors](#report-skill-call-errors))\n\n### API Documentation Reference\n\n- Shareholder List: Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n- Error Report: Check [references/skill-error-report-api.md](references/skill-error-report-api.md)\n\n## Best Practices\n\n1. **Check API documentation**:\n - **Before executing queries, must first check the corresponding API reference documentation**\n - Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n - Do not guess parameter names, get accurate parameter names and formats from documentation\n\n2. **Query parameters**:\n - The company ID (pid) is required. If the user provides a company name instead of a pid, first use **global-company-search** to find the company and obtain its pid. It can also be obtained from other global company search skills.\n\n## Notes\n- Shareholder records use `shareholderId` as the unique identifier\n- Shareholding ratio is returned as a string with percentage sign (e.g., \"60.00%\")\n- The `total` field indicates the total number of shareholders\n- File paths use forward slashes on all platforms\n- **Prohibit outputting technical parameter format**: Do not display code-style parameters in responses, convert to natural language\n- **Do not** estimate or guess per-call fees — use `python scripts/auth.py --price_info` to get accurate pricing information\n- **Do not** guess parameter names, get accurate parameter names and formats from documentation\n\n## Related Skills\n\nOther UpKuaJing skills you might find useful:\n\n- global-company-search — Search companies from the global company database\n- global-company-person-search — Search people from the global company database\n- global-company-employee — Query employee list from the global company database\n- global-company-person-colleague — Query colleague list from the global company database\n- global-company-person-alumni — Query alumni list from the global company database\n- global-company-person-experience — Query work experience list from the global company database\n- global-company-person-education — Query education history list from the global company database\n- global-company-person-school-detail — Query school detail from the global company database\n- linkedin-person-search — Search people from LinkedIn data\n- linkedin-company-search — Search companies from LinkedIn data\n- upkuajing-global-company-people-search — Unified company and people search across all sources\n- upkuajing-customs-trade-company-search — Search customs trade companies\n- upkuajing-contact-info-validity-check — Check contact info validity\n- phone-validity-check — Check phone number validity\n- email-validity-check — Check email address validity\n- domain-validity-check — Check domain validity and security\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn76ywjzma121r2rh959ejsf49834c6x\",\n \"slug\": \"global-company-shareholder\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1787562945783\n}\n\nFile v1.0.4:references/company-shareholder-list-api.md\n\n# 全球企业库股东列表 API 参考\n\n> 根据公司ID获取公司的股东信息。\n> 接口路径：`POST /agent/search/depth_company/company/shareholder/list`\n\n## python脚本参数\n\n- `--pid`：公司ID（必填），如 `US_12345`\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pid | string | 是 | 公司ID |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：响应码，0 表示成功\n- msg（string）：响应消息\n- data：股东列表数据（见下）\n- fee：计费信息（apiCost 本次扣费、accountBalance 账户余额、uuid 调用标识）\n\n### data 字段\n\n- total（integer）：股东总数\n- list（array）：股东列表\n\n### list 股东字段\n\n- pid（string）：公司ID\n- shareholderId（string）：股东ID\n- shareholderName（string）：股东名称\n- shareholderType（integer）：股东类型\n- shareholderDirect（string）：持股方式（如 \"direct\"）\n- shareholderTotal（string）：持股比例（如 \"60.00%\"）\n\nFile v1.0.4:references/skill-error-report-api.md\n\n# Agent调用Skill异常上报 API 参考\n\n> 上报 Agent 调用 Skill 异常，用于平台侧问题追踪与优化。异常上报不产生查询费用。\n> 接口路径：`POST /agent/skill/error/report`\n> 鉴权：需要 Bearer 令牌（UPKUAJING_API_KEY）\n\n## python脚本参数\n\n- `--params`：JSON格式的上报参数（必填）\n- 未传 `skillId`/`skillVersion` 时，脚本会自动从当前 Skill 目录名与 SKILL.md 读取并填充\n- 必填参数：`skillId`、`skillVersion`、`requestId`、`requestPath`、`context`；其中 `requestId` 从出问题的请求响应（ApiResp.requestId）中获取\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| skillId | string | 是 | Skill 标识（最大128字符），如\"customs-analysis-area\" |\n| skillVersion | string | 是 | Skill 版本（最大32字符） |\n| agentName | string | 否 | Agent 名称（最大128字符） |\n| modelName | string | 否 | 模型名称（最大128字符） |\n| requestPath | string | 是 | 出问题的站内接口路径，以 / 开头（最大255字符），如\"/agent/customs/analysis/area\" |\n| requestId | string | 是 | 全请求唯一关联号（最大128字符），取失败请求响应中的 requestId |\n| requestTime | long | 否 | 请求发起时间戳（毫秒，≥0） |\n| requestParams | object | 否 | 请求参数（原始入参，敏感字段会自动脱敏；序列化后≤64KB） |\n| responseData | object | 否 | 响应数据（异常发生时的返回内容，敏感字段会自动脱敏；序列化后≤64KB） |\n| durationMs | long | 否 | 本次调用耗时（毫秒，≥0） |\n| context | string | 是 | 异常上下文（堆栈/错误信息，用于定位根因，最大2000字符） |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：状态码，0 表示成功\n- msg（string）：提示信息\n- requestId（string）：全请求唯一关联号（32位无横线，与 MDC traceId 同值）\n\n### data 字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| reportId | long | 上报记录 ID |\n\nFile v1.0.4:skill-card.md\n\n## Description:\n\nRetrieves shareholder records and ownership details for a company ID from UpKuaJing's global company database.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[upkuajing](https://clawhub.ai/user/upkuajing)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nInvestors, industry analysts, sales teams, and risk management specialists use this skill to inspect shareholder rosters, ownership ratios, and related equity-structure details for due diligence, investment research, competitor analysis, and controller checks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill performs paid API calls and includes account top-up helper commands.\n\nMitigation: Before any fee-incurring call, inform the user that fees apply, check current pricing through the provided price source or price command, and wait for explicit confirmation in a separate response.\n\nRisk: The skill can read or write UPKUAJING_API_KEY in a local plaintext file at ~/.upkuajing/.env.\n\nMitigation: Prefer a safer secret mechanism such as an environment variable or secret manager; if the local file is used, ensure it is owner-only readable and never print its contents.\n\nRisk: Confirmed error reports are sent to the UpKuaJing platform and may include request context.\n\nMitigation: Submit error reports only after user confirmation and avoid including sensitive business, account, or credential data in report context.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/upkuajing/skills/global-company-shareholder)\n- [UpKuaJing Homepage](https://www.upkuajing.com)\n- [UpKuaJing Open Platform](https://developer.upkuajing.com/)\n- [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)\n- [Company Shareholder List API](references/company-shareholder-list-api.md)\n- [Skill Error Report API](references/skill-error-report-api.md)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Text, Shell commands, Guidance]\n\n**Output Format:** [JSON API responses with concise natural-language guidance and shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a company ID and UPKUAJING_API_KEY; successful shareholder queries include result data, fee details, and a request identifier.]\n\n## Skill Version(s):\n\n1.0.4 (source: frontmatter and server 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\nFile v1.0.4:requirements.txt\n\nhttpx>=0.23.0\n\nArchive v1.0.3: 9 files, 15424 bytes\n\nFiles: references/company-shareholder-list-api.md (1017b), requirements.txt (14b), scripts/auth.py (5860b), scripts/common.py (14567b), scripts/company_shareholder_list.py (1241b), scripts/version_check.py (4933b), skill-card.md (2514b), SKILL.md (7554b), _meta.json (145b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: global-company-shareholder\ndescription: \"Retrieve overseas shareholders, executives and ultimate beneficial owners by company ID. Analyze equity structure for due‑diligence, investment research and competitor background checks.\\n\\nTrigger: ultimate beneficial owner check, corporate equity structure lookup, overseas shareholder research, company due‑diligence, related‑party transaction screening, identify actual company controllers\"\nmetadata: {\"version\":\"1.0.3\",\"homepage\":\"https://www.upkuajing.com\",\"clawdbot\":{\"emoji\":\"🏛️\",\"requires\":{\"bins\":[\"python\"],\"env\":[\"UPKUAJING_API_KEY\"]},\"primaryEnv\":\"UPKUAJING_API_KEY\"}}\n---\n\n# Global Company Shareholder Query\n\nQuery shareholder data from the global company database (全球企业库) using the UpKuaJing Open Platform API.\n\n## Overview\n\nThis skill provides access to shareholder information from UpKuaJing's global company database. Given a company ID (pid), it returns the list of shareholders with their IDs, names, types, shareholding methods, and ratios.\n\n**Prerequisite**: The company ID (pid) is required as input. If the user does not already have a company ID, use the **global-company-search** skill first to search for the target company and obtain its pid, then proceed with this skill.\n\n## Running Scripts\n\n### Environment Setup\n\n1. **Check Python**: `python --version`\n2. **Install dependencies**: `pip install -r requirements.txt`\n\nScript directory: `scripts/*.py`\nRun example: `python scripts/*.py`\n\n**Important**: Always use direct script invocation like `python scripts/company_shareholder_list.py`. **Do NOT use** shell compound commands like `cd scripts && python company_shareholder_list.py`\n\n### Shareholder List Query (`company_shareholder_list.py`)\n- **Return granularity**: Each shareholder as one record\n- **Use cases**: Query shareholders of a specific company\n- **Example**:\n - \"Who are the shareholders of company US_12345?\"\n - \"Get shareholder details for pid US_12345\"\n- **Parameters**: See [Shareholder List API](references/company-shareholder-list-api.md)\n\n## API Key and Top-up\n\nThis skill requires an API key. The API key is stored in the `~/.upkuajing/.env` file:\n```bash\ncat ~/.upkuajing/.env\n```\n**Example file content**:\n```\nUPKUAJING_API_KEY=your_api_key_here\n```\n### **API Key Not Set**\nFirst check if the `~/.upkuajing/.env` file has UPKUAJING_API_KEY;\nIf UPKUAJING_API_KEY is not set, prompt the user to choose:\n1. User has one: User provides it (manually add to ~/.upkuajing/.env file)\n2. User doesn't have one: You can apply using the interface (`auth.py --new_key`), the new key will be automatically saved to ~/.upkuajing/.env\nWait for user selection;\n\n### **Account Top-up**\nWhen API response indicates insufficient balance, explain and guide user to top up:\n1. Create top-up order (`auth.py --new_rec_order`)\n2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;\n\n### **Get Account Information**\nUse this script to get account information for UPKUAJING_API_KEY: `auth.py --account_info`\n\n## API Key and UpKuaJing Account\n- Newly applied API key: Register and login at [UpKuaJing Open Platform](https://developer.upkuajing.com/), then bind account\n\n## Fees\n\n**All API calls incur fees**, different interfaces have different billing methods.\n\n**Latest pricing**: Users can visit [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)\nOr use: `python scripts/auth.py --price_info` (returns complete pricing for all interfaces)\n\n### Query Billing Rules\n\nBilled by **number of calls**, each call returns shareholder data for one company:\n- Each API call incurs a fee\n- **Before execution:**\n 1. Inform user that this query will incur a fee\n 2. Stop, wait for explicit user confirmation in a separate message, then execute script\n\n### Fee Confirmation Principle\n\n**Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.**\n\n## Workflow\n\n### Decision Guide\n\n| User Intent | Use API |\n|-------------|---------|\n| \"Who are the shareholders of company US_12345?\" | Shareholder List Query |\n| User has a company name but no pid | global-company-search (find the company and get its pid, then use this skill) |\n\n## Usage Examples\n\n### Query Shareholder List\n\n**User request**: \"Who are the shareholders of company US_12345?\"\n```bash\npython scripts/company_shareholder_list.py --pid US_12345\n```\n\n## Error Handling\n\n- **API key invalid/non-existent**: Check `UPKUAJING_API_KEY` in `~/.upkuajing/.env` file\n- **Insufficient balance**: Guide user to top up\n- **Invalid parameters**: **Must first check the corresponding API documentation in references/ directory**, get correct parameter names and formats from documentation, do not guess\n\n### API Documentation Reference\n\n- Shareholder List: Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n\n## Best Practices\n\n1. **Check API documentation**:\n - **Before executing queries, must first check the corresponding API reference documentation**\n - Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n - Do not guess parameter names, get accurate parameter names and formats from documentation\n\n2. **Query parameters**:\n - The company ID (pid) is required. If the user provides a company name instead of a pid, first use **global-company-search** to find the company and obtain its pid. It can also be obtained from other global company search skills.\n\n## Notes\n- Shareholder records use `shareholderId` as the unique identifier\n- Shareholding ratio is returned as a string with percentage sign (e.g., \"60.00%\")\n- The `total` field indicates the total number of shareholders\n- File paths use forward slashes on all platforms\n- **Prohibit outputting technical parameter format**: Do not display code-style parameters in responses, convert to natural language\n- **Do not** estimate or guess per-call fees — use `python scripts/auth.py --price_info` to get accurate pricing information\n- **Do not** guess parameter names, get accurate parameter names and formats from documentation\n\n## Related Skills\n\nOther UpKuaJing skills you might find useful:\n\n- global-company-search — Search companies from the global company database\n- global-company-person-search — Search people from the global company database\n- global-company-employee — Query employee list from the global company database\n- global-company-person-colleague — Query colleague list from the global company database\n- global-company-person-alumni — Query alumni list from the global company database\n- global-company-person-experience — Query work experience list from the global company database\n- global-company-person-education — Query education history list from the global company database\n- global-company-person-school-detail — Query school detail from the global company database\n- linkedin-person-search — Search people from LinkedIn data\n- linkedin-company-search — Search companies from LinkedIn data\n- upkuajing-global-company-people-search — Unified company and people search across all sources\n- upkuajing-customs-trade-company-search — Search customs trade companies\n- upkuajing-contact-info-validity-check — Check contact info validity\n- phone-validity-check — Check phone number validity\n- email-validity-check — Check email address validity\n- domain-validity-check — Check domain validity and security\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn76ywjzma121r2rh959ejsf49834c6x\",\n \"slug\": \"global-company-shareholder\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1784192432234\n}\n\nFile v1.0.3:references/company-shareholder-list-api.md\n\n# 全球企业库股东列表 API 参考\n\n> 根据公司ID获取公司的股东信息。\n> 接口路径：`POST /agent/search/depth_company/company/shareholder/list`\n\n## python脚本参数\n\n- `--pid`：公司ID（必填），如 `US_12345`\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pid | string | 是 | 公司ID |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：响应码，0 表示成功\n- msg（string）：响应消息\n- data：股东列表数据（见下）\n- fee：计费信息（apiCost 本次扣费、accountBalance 账户余额、uuid 调用标识）\n\n### data 字段\n\n- total（integer）：股东总数\n- list（array）：股东列表\n\n### list 股东字段\n\n- pid（string）：公司ID\n- shareholderId（string）：股东ID\n- shareholderName（string）：股东名称\n- shareholderType（integer）：股东类型\n- shareholderDirect（string）：持股方式（如 \"direct\"）\n- shareholderTotal（string）：持股比例（如 \"60.00%\"）\n\nFile v1.0.3:skill-card.md\n\n## Description:
\nRetrieves company shareholder, executive, and beneficial-owner information from UpKuaJing's global company database by company ID.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[upkuajing](https://clawhub.ai/user/upkuajing)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, investors, industry analysts, sales teams, and risk specialists use this skill to look up shareholder rosters, ownership ratios, and beneficial-owner signals for due diligence, investment research, competitor analysis, related-party screening, and B2B prospecting.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: API calls and account top-ups may incur charges through UpKuaJing's paid API.
\nMitigation: Review current pricing and require explicit user confirmation before running billable queries or creating top-up orders.
\nRisk: The billable API key may be stored locally in ~/.upkuajing/.env.
\nMitigation: Keep the file private, avoid sharing logs or screenshots that expose credentials, and rotate the key if it may have been disclosed.
\nRisk: The skill performs an automatic version check against the UpKuaJing API.
\nMitigation: Account for this outbound request when reviewing network behavior and deployment policy.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/upkuajing/skills/global-company-shareholder)
\n- [UpKuaJing homepage](https://www.upkuajing.com)
\n- [UpKuaJing Open Platform](https://developer.upkuajing.com/)
\n- [UpKuaJing OpenAPI pricing](https://www.upkuajing.com/web/openapi/price.html)
\n- [Shareholder List API reference](references/company-shareholder-list-api.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [JSON, Shell commands, Guidance]
\n**Output Format:** [JSON responses and Markdown guidance with inline shell commands]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a company ID and an UPKUAJING_API_KEY; successful responses include shareholder list data and fee metadata.]
\n\n## Skill Version(s):
\n1.0.3 (source: server release evidence and skill metadata)
\n\n## Ethical Considerations:
\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\nFile v1.0.3:requirements.txt\n\nhttpx>=0.23.0\n\nArchive v1.0.2: 9 files, 15567 bytes\n\nFiles: references/company-shareholder-list-api.md (1017b), requirements.txt (14b), scripts/auth.py (5860b), scripts/common.py (14567b), scripts/company_shareholder_list.py (1241b), scripts/version_check.py (4933b), skill-card.md (2955b), SKILL.md (7554b), _meta.json (145b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: global-company-shareholder\ndescription: \"Retrieve overseas shareholders, executives and ultimate beneficial owners by company ID. Analyze equity structure for due‑diligence, investment research and competitor background checks.\\n\\nTrigger: ultimate beneficial owner check, corporate equity structure lookup, overseas shareholder research, company due‑diligence, related‑party transaction screening, identify actual company controllers\"\nmetadata: {\"version\":\"1.0.2\",\"homepage\":\"https://www.upkuajing.com\",\"clawdbot\":{\"emoji\":\"🏛️\",\"requires\":{\"bins\":[\"python\"],\"env\":[\"UPKUAJING_API_KEY\"]},\"primaryEnv\":\"UPKUAJING_API_KEY\"}}\n---\n\n# Global Company Shareholder Query\n\nQuery shareholder data from the global company database (全球企业库) using the UpKuaJing Open Platform API.\n\n## Overview\n\nThis skill provides access to shareholder information from UpKuaJing's global company database. Given a company ID (pid), it returns the list of shareholders with their IDs, names, types, shareholding methods, and ratios.\n\n**Prerequisite**: The company ID (pid) is required as input. If the user does not already have a company ID, use the **global-company-search** skill first to search for the target company and obtain its pid, then proceed with this skill.\n\n## Running Scripts\n\n### Environment Setup\n\n1. **Check Python**: `python --version`\n2. **Install dependencies**: `pip install -r requirements.txt`\n\nScript directory: `scripts/*.py`\nRun example: `python scripts/*.py`\n\n**Important**: Always use direct script invocation like `python scripts/company_shareholder_list.py`. **Do NOT use** shell compound commands like `cd scripts && python company_shareholder_list.py`\n\n### Shareholder List Query (`company_shareholder_list.py`)\n- **Return granularity**: Each shareholder as one record\n- **Use cases**: Query shareholders of a specific company\n- **Example**:\n - \"Who are the shareholders of company US_12345?\"\n - \"Get shareholder details for pid US_12345\"\n- **Parameters**: See [Shareholder List API](references/company-shareholder-list-api.md)\n\n## API Key and Top-up\n\nThis skill requires an API key. The API key is stored in the `~/.upkuajing/.env` file:\n```bash\ncat ~/.upkuajing/.env\n```\n**Example file content**:\n```\nUPKUAJING_API_KEY=your_api_key_here\n```\n### **API Key Not Set**\nFirst check if the `~/.upkuajing/.env` file has UPKUAJING_API_KEY;\nIf UPKUAJING_API_KEY is not set, prompt the user to choose:\n1. User has one: User provides it (manually add to ~/.upkuajing/.env file)\n2. User doesn't have one: You can apply using the interface (`auth.py --new_key`), the new key will be automatically saved to ~/.upkuajing/.env\nWait for user selection;\n\n### **Account Top-up**\nWhen API response indicates insufficient balance, explain and guide user to top up:\n1. Create top-up order (`auth.py --new_rec_order`)\n2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;\n\n### **Get Account Information**\nUse this script to get account information for UPKUAJING_API_KEY: `auth.py --account_info`\n\n## API Key and UpKuaJing Account\n- Newly applied API key: Register and login at [UpKuaJing Open Platform](https://developer.upkuajing.com/), then bind account\n\n## Fees\n\n**All API calls incur fees**, different interfaces have different billing methods.\n\n**Latest pricing**: Users can visit [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)\nOr use: `python scripts/auth.py --price_info` (returns complete pricing for all interfaces)\n\n### Query Billing Rules\n\nBilled by **number of calls**, each call returns shareholder data for one company:\n- Each API call incurs a fee\n- **Before execution:**\n 1. Inform user that this query will incur a fee\n 2. Stop, wait for explicit user confirmation in a separate message, then execute script\n\n### Fee Confirmation Principle\n\n**Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.**\n\n## Workflow\n\n### Decision Guide\n\n| User Intent | Use API |\n|-------------|---------|\n| \"Who are the shareholders of company US_12345?\" | Shareholder List Query |\n| User has a company name but no pid | global-company-search (find the company and get its pid, then use this skill) |\n\n## Usage Examples\n\n### Query Shareholder List\n\n**User request**: \"Who are the shareholders of company US_12345?\"\n```bash\npython scripts/company_shareholder_list.py --pid US_12345\n```\n\n## Error Handling\n\n- **API key invalid/non-existent**: Check `UPKUAJING_API_KEY` in `~/.upkuajing/.env` file\n- **Insufficient balance**: Guide user to top up\n- **Invalid parameters**: **Must first check the corresponding API documentation in references/ directory**, get correct parameter names and formats from documentation, do not guess\n\n### API Documentation Reference\n\n- Shareholder List: Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n\n## Best Practices\n\n1. **Check API documentation**:\n - **Before executing queries, must first check the corresponding API reference documentation**\n - Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n - Do not guess parameter names, get accurate parameter names and formats from documentation\n\n2. **Query parameters**:\n - The company ID (pid) is required. If the user provides a company name instead of a pid, first use **global-company-search** to find the company and obtain its pid. It can also be obtained from other global company search skills.\n\n## Notes\n- Shareholder records use `shareholderId` as the unique identifier\n- Shareholding ratio is returned as a string with percentage sign (e.g., \"60.00%\")\n- The `total` field indicates the total number of shareholders\n- File paths use forward slashes on all platforms\n- **Prohibit outputting technical parameter format**: Do not display code-style parameters in responses, convert to natural language\n- **Do not** estimate or guess per-call fees — use `python scripts/auth.py --price_info` to get accurate pricing information\n- **Do not** guess parameter names, get accurate parameter names and formats from documentation\n\n## Related Skills\n\nOther UpKuaJing skills you might find useful:\n\n- global-company-search — Search companies from the global company database\n- global-company-person-search — Search people from the global company database\n- global-company-employee — Query employee list from the global company database\n- global-company-person-colleague — Query colleague list from the global company database\n- global-company-person-alumni — Query alumni list from the global company database\n- global-company-person-experience — Query work experience list from the global company database\n- global-company-person-education — Query education history list from the global company database\n- global-company-person-school-detail — Query school detail from the global company database\n- linkedin-person-search — Search people from LinkedIn data\n- linkedin-company-search — Search companies from LinkedIn data\n- upkuajing-global-company-people-search — Unified company and people search across all sources\n- upkuajing-customs-trade-company-search — Search customs trade companies\n- upkuajing-contact-info-validity-check — Check contact info validity\n- phone-validity-check — Check phone number validity\n- email-validity-check — Check email address validity\n- domain-validity-check — Check domain validity and security\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn76ywjzma121r2rh959ejsf49834c6x\",\n \"slug\": \"global-company-shareholder\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1784183061842\n}\n\nFile v1.0.2:references/company-shareholder-list-api.md\n\n# 全球企业库股东列表 API 参考\n\n> 根据公司ID获取公司的股东信息。\n> 接口路径：`POST /agent/search/depth_company/company/shareholder/list`\n\n## python脚本参数\n\n- `--pid`：公司ID（必填），如 `US_12345`\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pid | string | 是 | 公司ID |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：响应码，0 表示成功\n- msg（string）：响应消息\n- data：股东列表数据（见下）\n- fee：计费信息（apiCost 本次扣费、accountBalance 账户余额、uuid 调用标识）\n\n### data 字段\n\n- total（integer）：股东总数\n- list（array）：股东列表\n\n### list 股东字段\n\n- pid（string）：公司ID\n- shareholderId（string）：股东ID\n- shareholderName（string）：股东名称\n- shareholderType（integer）：股东类型\n- shareholderDirect（string）：持股方式（如 \"direct\"）\n- shareholderTotal（string）：持股比例（如 \"60.00%\"）\n\nFile v1.0.2:skill-card.md\n\n## Description:
\nRetrieve overseas shareholders, executives and ultimate beneficial owners by company ID for due diligence, investment research, competitor background checks, and related-party screening.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[upkuajing](https://clawhub.ai/user/upkuajing)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal business users, analysts, sales teams, and risk-management specialists use this skill to retrieve shareholder lists, ownership ratios, shareholding methods, and beneficial-owner signals for a known company ID. It supports corporate due diligence, investment analysis, competitor relationship research, and related-party transaction screening.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill handles queried company data and uses a third-party API service.
\nMitigation: Install only if the user trusts UpKuaJing with the submitted company IDs and related lookup data.
\nRisk: The skill reads and may write a plaintext API key at ~/.upkuajing/.env.
\nMitigation: Use a dedicated API key where possible, restrict local file access, and rotate the key if it may have been exposed.
\nRisk: The skill can create payment or recharge orders and normal lookup calls may incur fees.
\nMitigation: Require explicit user confirmation before paid API calls, top-up flows, or payment-order creation.
\nRisk: Security evidence flags account details, payment-order creation, and version-check behavior as requiring review before installation.
\nMitigation: Review the security summary and guidance before deployment and monitor agent actions involving account, payment, or update prompts.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/upkuajing/skills/global-company-shareholder)
\n- [UpKuaJing homepage](https://www.upkuajing.com)
\n- [UpKuaJing Open Platform](https://developer.upkuajing.com/)
\n- [Detailed price description](https://www.upkuajing.com/web/openapi/price.html)
\n- [Global company shareholder list API reference](references/company-shareholder-list-api.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with shell commands and JSON API results]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a company ID and an UPKUAJING_API_KEY; API calls may incur fees and should be confirmed before execution.]
\n\n## Skill Version(s):
\n1.0.2 (source: frontmatter and server release evidence)
\n\n## Ethical Considerations:
\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\nFile v1.0.2:requirements.txt\n\nhttpx>=0.23.0\n\nArchive v1.0.1: 9 files, 15226 bytes\n\nFiles: references/company-shareholder-list-api.md (1017b), requirements.txt (14b), scripts/auth.py (5860b), scripts/common.py (14567b), scripts/company_shareholder_list.py (1241b), scripts/version_check.py (4933b), skill-card.md (2438b), SKILL.md (7300b), _meta.json (145b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: global-company-shareholder\ndescription: Official skill for upkuajing (跨境魔方). Query shareholder list (股东列表) from the global company database (全球企业库). Get shareholder information including name, shareholding ratio, and shareholding type by company ID. Requires a company ID (pid) — obtain it first via the global-company-search skill.\nmetadata: {\"version\":\"1.0.1\",\"homepage\":\"https://www.upkuajing.com\",\"clawdbot\":{\"emoji\":\"🏛️\",\"requires\":{\"bins\":[\"python\"],\"env\":[\"UPKUAJING_API_KEY\"]},\"primaryEnv\":\"UPKUAJING_API_KEY\"}}\n---\n\n# Global Company Shareholder Query\n\nQuery shareholder data from the global company database (全球企业库) using the UpKuaJing Open Platform API.\n\n## Overview\n\nThis skill provides access to shareholder information from UpKuaJing's global company database. Given a company ID (pid), it returns the list of shareholders with their IDs, names, types, shareholding methods, and ratios.\n\n**Prerequisite**: The company ID (pid) is required as input. If the user does not already have a company ID, use the **global-company-search** skill first to search for the target company and obtain its pid, then proceed with this skill.\n\n## Running Scripts\n\n### Environment Setup\n\n1. **Check Python**: `python --version`\n2. **Install dependencies**: `pip install -r requirements.txt`\n\nScript directory: `scripts/*.py`\nRun example: `python scripts/*.py`\n\n**Important**: Always use direct script invocation like `python scripts/company_shareholder_list.py`. **Do NOT use** shell compound commands like `cd scripts && python company_shareholder_list.py`\n\n### Shareholder List Query (`company_shareholder_list.py`)\n- **Return granularity**: Each shareholder as one record\n- **Use cases**: Query shareholders of a specific company\n- **Example**:\n - \"Who are the shareholders of company US_12345?\"\n - \"Get shareholder details for pid US_12345\"\n- **Parameters**: See [Shareholder List API](references/company-shareholder-list-api.md)\n\n## API Key and Top-up\n\nThis skill requires an API key. The API key is stored in the `~/.upkuajing/.env` file:\n```bash\ncat ~/.upkuajing/.env\n```\n**Example file content**:\n```\nUPKUAJING_API_KEY=your_api_key_here\n```\n### **API Key Not Set**\nFirst check if the `~/.upkuajing/.env` file has UPKUAJING_API_KEY;\nIf UPKUAJING_API_KEY is not set, prompt the user to choose:\n1. User has one: User provides it (manually add to ~/.upkuajing/.env file)\n2. User doesn't have one: You can apply using the interface (`auth.py --new_key`), the new key will be automatically saved to ~/.upkuajing/.env\nWait for user selection;\n\n### **Account Top-up**\nWhen API response indicates insufficient balance, explain and guide user to top up:\n1. Create top-up order (`auth.py --new_rec_order`)\n2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;\n\n### **Get Account Information**\nUse this script to get account information for UPKUAJING_API_KEY: `auth.py --account_info`\n\n## API Key and UpKuaJing Account\n- Newly applied API key: Register and login at [UpKuaJing Open Platform](https://developer.upkuajing.com/), then bind account\n\n## Fees\n\n**All API calls incur fees**, different interfaces have different billing methods.\n\n**Latest pricing**: Users can visit [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)\nOr use: `python scripts/auth.py --price_info` (returns complete pricing for all interfaces)\n\n### Query Billing Rules\n\nBilled by **number of calls**, each call returns shareholder data for one company:\n- Each API call incurs a fee\n- **Before execution:**\n 1. Inform user that this query will incur a fee\n 2. Stop, wait for explicit user confirmation in a separate message, then execute script\n\n### Fee Confirmation Principle\n\n**Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.**\n\n## Workflow\n\n### Decision Guide\n\n| User Intent | Use API |\n|-------------|---------|\n| \"Who are the shareholders of company US_12345?\" | Shareholder List Query |\n| User has a company name but no pid | global-company-search (find the company and get its pid, then use this skill) |\n\n## Usage Examples\n\n### Query Shareholder List\n\n**User request**: \"Who are the shareholders of company US_12345?\"\n```bash\npython scripts/company_shareholder_list.py --pid US_12345\n```\n\n## Error Handling\n\n- **API key invalid/non-existent**: Check `UPKUAJING_API_KEY` in `~/.upkuajing/.env` file\n- **Insufficient balance**: Guide user to top up\n- **Invalid parameters**: **Must first check the corresponding API documentation in references/ directory**, get correct parameter names and formats from documentation, do not guess\n\n### API Documentation Reference\n\n- Shareholder List: Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n\n## Best Practices\n\n1. **Check API documentation**:\n - **Before executing queries, must first check the corresponding API reference documentation**\n - Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n - Do not guess parameter names, get accurate parameter names and formats from documentation\n\n2. **Query parameters**:\n - The company ID (pid) is required. If the user provides a company name instead of a pid, first use **global-company-search** to find the company and obtain its pid. It can also be obtained from other global company search skills.\n\n## Notes\n- Shareholder records use `shareholderId` as the unique identifier\n- Shareholding ratio is returned as a string with percentage sign (e.g., \"60.00%\")\n- The `total` field indicates the total number of shareholders\n- File paths use forward slashes on all platforms\n- **Prohibit outputting technical parameter format**: Do not display code-style parameters in responses, convert to natural language\n- **Do not** estimate or guess per-call fees — use `python scripts/auth.py --price_info` to get accurate pricing information\n- **Do not** guess parameter names, get accurate parameter names and formats from documentation\n\n## Related Skills\n\nOther UpKuaJing skills you might find useful:\n\n- global-company-search — Search companies from the global company database\n- global-company-person-search — Search people from the global company database\n- global-company-employee — Query employee list from the global company database\n- global-company-person-colleague — Query colleague list from the global company database\n- global-company-person-alumni — Query alumni list from the global company database\n- global-company-person-experience — Query work experience list from the global company database\n- global-company-person-education — Query education history list from the global company database\n- global-company-person-school-detail — Query school detail from the global company database\n- linkedin-person-search — Search people from LinkedIn data\n- linkedin-company-search — Search companies from LinkedIn data\n- upkuajing-global-company-people-search — Unified company and people search across all sources\n- upkuajing-customs-trade-company-search — Search customs trade companies\n- upkuajing-contact-info-validity-check — Check contact info validity\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn76ywjzma121r2rh959ejsf49834c6x\",\n \"slug\": \"global-company-shareholder\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1783676852732\n}\n\nFile v1.0.1:references/company-shareholder-list-api.md\n\n# 全球企业库股东列表 API 参考\n\n> 根据公司ID获取公司的股东信息。\n> 接口路径：`POST /agent/search/depth_company/company/shareholder/list`\n\n## python脚本参数\n\n- `--pid`：公司ID（必填），如 `US_12345`\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pid | string | 是 | 公司ID |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：响应码，0 表示成功\n- msg（string）：响应消息\n- data：股东列表数据（见下）\n- fee：计费信息（apiCost 本次扣费、accountBalance 账户余额、uuid 调用标识）\n\n### data 字段\n\n- total（integer）：股东总数\n- list（array）：股东列表\n\n### list 股东字段\n\n- pid（string）：公司ID\n- shareholderId（string）：股东ID\n- shareholderName（string）：股东名称\n- shareholderType（integer）：股东类型\n- shareholderDirect（string）：持股方式（如 \"direct\"）\n- shareholderTotal（string）：持股比例（如 \"60.00%\"）\n\nFile v1.0.1:skill-card.md\n\n## Description:
\nQueries UpKuaJing's global company database for shareholder lists by company ID, including shareholder names, ownership ratios, and share types.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[upkuajing](https://clawhub.ai/user/upkuajing)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users such as investors, analysts, and business developers use this skill to retrieve shareholder lists by company ID for due diligence, ownership research, stakeholder verification, and corporate relationship analysis.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill handles paid API usage and account top-up actions.
\nMitigation: Confirm any paid query or top-up action with the user before execution and check current pricing through the documented pricing command or page.
\nRisk: The skill stores and reads an UpKuaJing API key from the local user profile.
\nMitigation: Avoid exposing the local .env contents in chat or logs, and treat the API key as a secret.
\nRisk: Normal API calls also perform a version check and write a local version cache.
\nMitigation: Review this behavior before deployment in environments where outbound checks or local cache writes are restricted.
\n\n\n## Reference(s):
\n- [Shareholder List API Reference](references/company-shareholder-list-api.md)
\n- [UpKuaJing Homepage](https://www.upkuajing.com)
\n- [UpKuaJing Open Platform](https://developer.upkuajing.com/)
\n- [UpKuaJing API Pricing](https://www.upkuajing.com/web/openapi/price.html)
\n- [ClawHub Skill Page](https://clawhub.ai/upkuajing/skills/global-company-shareholder)
\n\n\n## Skill Output:
\n**Output Type(s):** [JSON, Shell commands, Guidance]
\n**Output Format:** [Markdown guidance with shell commands and JSON API responses]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a company ID and may return fee information with shareholder data.]
\n\n## Skill Version(s):
\n1.0.1 (source: server release evidence and skill metadata)
\n\n## Ethical Considerations:
\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\nFile v1.0.1:requirements.txt\n\nhttpx>=0.23.0\n\nArchive v1.0.0: 9 files, 15291 bytes\n\nFiles: references/company-shareholder-list-api.md (1003b), requirements.txt (14b), scripts/auth.py (5860b), scripts/common.py (14567b), scripts/company_shareholder_list.py (1227b), scripts/version_check.py (4933b), skill-card.md (2733b), SKILL.md (7006b), _meta.json (145b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: global-company-shareholder\ndescription: Official skill for upkuajing (跨境魔方). Query shareholder list (股东列表) from the global company database (全球企业库). Get shareholder information including name, shareholding ratio, and shareholding type by company ID. Requires a company ID (pid) — obtain it first via the global-company-search skill.\nmetadata: {\"version\":\"1.0.0\",\"homepage\":\"https://www.upkuajing.com\",\"clawdbot\":{\"emoji\":\"🏛️\",\"requires\":{\"bins\":[\"python\"],\"env\":[\"UPKUAJING_API_KEY\"]},\"primaryEnv\":\"UPKUAJING_API_KEY\"}}\n---\n\n# Global Company Shareholder Query\n\nQuery shareholder data from the global company database (全球企业库) using the UpKuaJing Open Platform API.\n\n## Overview\n\nThis skill provides access to shareholder information from UpKuaJing's global company database. Given a company ID (pid), it returns the list of shareholders with their IDs, names, types, shareholding methods, and ratios.\n\n**Prerequisite**: The company ID (pid) is required as input. If the user does not already have a company ID, use the **global-company-search** skill first to search for the target company and obtain its pid, then proceed with this skill.\n\n## Running Scripts\n\n### Environment Setup\n\n1. **Check Python**: `python --version`\n2. **Install dependencies**: `pip install -r requirements.txt`\n\nScript directory: `scripts/*.py`\nRun example: `python scripts/*.py`\n\n**Important**: Always use direct script invocation like `python scripts/company_shareholder_list.py`. **Do NOT use** shell compound commands like `cd scripts && python company_shareholder_list.py`\n\n### Shareholder List Query (`company_shareholder_list.py`)\n- **Return granularity**: Each shareholder as one record\n- **Use cases**: Query shareholders of a specific company\n- **Example**:\n - \"Who are the shareholders of company US_12345?\"\n - \"Get shareholder details for pid US_12345\"\n- **Parameters**: See [Shareholder List API](references/company-shareholder-list-api.md)\n\n## API Key and Top-up\n\nThis skill requires an API key. The API key is stored in the `~/.upkuajing/.env` file:\n```bash\ncat ~/.upkuajing/.env\n```\n**Example file content**:\n```\nUPKUAJING_API_KEY=your_api_key_here\n```\n### **API Key Not Set**\nFirst check if the `~/.upkuajing/.env` file has UPKUAJING_API_KEY;\nIf UPKUAJING_API_KEY is not set, prompt the user to choose:\n1. User has one: User provides it (manually add to ~/.upkuajing/.env file)\n2. User doesn't have one: You can apply using the interface (`auth.py --new_key`), the new key will be automatically saved to ~/.upkuajing/.env\nWait for user selection;\n\n### **Account Top-up**\nWhen API response indicates insufficient balance, explain and guide user to top up:\n1. Create top-up order (`auth.py --new_rec_order`)\n2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;\n\n### **Get Account Information**\nUse this script to get account information for UPKUAJING_API_KEY: `auth.py --account_info`\n\n## API Key and UpKuaJing Account\n- Newly applied API key: Register and login at [UpKuaJing Open Platform](https://developer.upkuajing.com/), then bind account\n\n## Fees\n\n**All API calls incur fees**, different interfaces have different billing methods.\n\n**Latest pricing**: Users can visit [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)\nOr use: `python scripts/auth.py --price_info` (returns complete pricing for all interfaces)\n\n### Query Billing Rules\n\nBilled by **number of calls**, each call returns shareholder data for one company:\n- Each API call incurs a fee\n- **Before execution:**\n 1. Inform user that this query will incur a fee\n 2. Stop, wait for explicit user confirmation in a separate message, then execute script\n\n### Fee Confirmation Principle\n\n**Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.**\n\n## Workflow\n\n### Decision Guide\n\n| User Intent | Use API |\n|-------------|---------|\n| \"Who are the shareholders of company US_12345?\" | Shareholder List Query |\n| User has a company name but no pid | global-company-search (find the company and get its pid, then use this skill) |\n\n## Usage Examples\n\n### Query Shareholder List\n\n**User request**: \"Who are the shareholders of company US_12345?\"\n```bash\npython scripts/company_shareholder_list.py --pid US_12345\n```\n\n## Error Handling\n\n- **API key invalid/non-existent**: Check `UPKUAJING_API_KEY` in `~/.upkuajing/.env` file\n- **Insufficient balance**: Guide user to top up\n- **Invalid parameters**: **Must first check the corresponding API documentation in references/ directory**, get correct parameter names and formats from documentation, do not guess\n\n### API Documentation Reference\n\n- Shareholder List: Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n\n## Best Practices\n\n1. **Check API documentation**:\n - **Before executing queries, must first check the corresponding API reference documentation**\n - Check [references/company-shareholder-list-api.md](references/company-shareholder-list-api.md)\n - Do not guess parameter names, get accurate parameter names and formats from documentation\n\n2. **Query parameters**:\n - The company ID (pid) is required. If the user provides a company name instead of a pid, first use **global-company-search** to find the company and obtain its pid. It can also be obtained from other global company search skills.\n\n## Notes\n- Shareholder records use `shareholderId` as the unique identifier\n- Shareholding ratio is returned as a string with percentage sign (e.g., \"60.00%\")\n- The `total` field indicates the total number of shareholders\n- File paths use forward slashes on all platforms\n- **Prohibit outputting technical parameter format**: Do not display code-style parameters in responses, convert to natural language\n- **Do not** estimate or guess per-call fees — use `python scripts/auth.py --price_info` to get accurate pricing information\n- **Do not** guess parameter names, get accurate parameter names and formats from documentation\n\n## Related Skills\n\nOther UpKuaJing skills you might find useful:\n\n- global-company-search — Search companies from the global company database\n- global-company-person-search — Search people from the global company database\n- global-company-employee — Query employee list from the global company database\n- global-company-person-colleague — Query colleague list from the global company database\n- global-company-person-alumni — Query alumni list from the global company database\n- linkedin-person-search — Search people from LinkedIn data\n- linkedin-company-search — Search companies from LinkedIn data\n- upkuajing-global-company-people-search — Unified company and people search across all sources\n- upkuajing-customs-trade-company-search — Search customs trade companies\n- upkuajing-contact-info-validity-check — Check contact info validity\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn76ywjzma121r2rh959ejsf49834c6x\",\n \"slug\": \"global-company-shareholder\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1783599847012\n}\n\nFile v1.0.0:references/company-shareholder-list-api.md\n\n# 全球企业库股东列表 API 参考\n\n> 根据公司ID获取公司的股东信息。\n> 接口路径：`POST /agent/search/company/shareholder/list`\n\n## python脚本参数\n\n- `--pid`：公司ID（必填），如 `US_12345`\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pid | string | 是 | 公司ID |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：响应码，0 表示成功\n- msg（string）：响应消息\n- data：股东列表数据（见下）\n- fee：计费信息（apiCost 本次扣费、accountBalance 账户余额、uuid 调用标识）\n\n### data 字段\n\n- total（integer）：股东总数\n- list（array）：股东列表\n\n### list 股东字段\n\n- pid（string）：公司ID\n- shareholderId（string）：股东ID\n- shareholderName（string）：股东名称\n- shareholderType（integer）：股东类型\n- shareholderDirect（string）：持股方式（如 \"direct\"）\n- shareholderTotal（string）：持股比例（如 \"60.00%\"）\n\nFile v1.0.0:skill-card.md\n\n## Description:
\nQueries UpKuaJing's global company database for shareholder names, identifiers, ownership ratios, share types, and shareholding methods by company ID.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[upkuajing](https://clawhub.ai/user/upkuajing)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal investors, analysts, and business development users can use this skill to retrieve shareholder lists for due diligence, ownership research, stakeholder verification, and corporate relationship analysis. The user or agent must already have a company ID, or obtain one through a company-search workflow before running the shareholder query.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill can read or write API credentials in persistent home-directory state.
\nMitigation: Use a dedicated UPKUAJING_API_KEY, avoid sharing raw keys in chat, and review any action that reads or writes ~/.upkuajing/.env.
\nRisk: The included account and top-up helper can perform account, recharge, payment-order, and new-key actions beyond a shareholder lookup.
\nMitigation: Require explicit user confirmation before account, recharge, payment-order, new-key, or fee-incurring query actions.
\nRisk: Shareholder queries incur API fees and return account balance information in fee metadata.
\nMitigation: Confirm expected charges before execution and avoid exposing fee or account details beyond the current user workflow.
\n\n\n## Reference(s):
\n- [Shareholder List API Reference](references/company-shareholder-list-api.md)
\n- [ClawHub Skill Page](https://clawhub.ai/upkuajing/skills/global-company-shareholder)
\n- [UpKuaJing Homepage](https://www.upkuajing.com)
\n- [UpKuaJing Open Platform](https://developer.upkuajing.com/)
\n- [UpKuaJing API Pricing](https://www.upkuajing.com/web/openapi/price.html)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, JSON, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with shell commands and formatted JSON API responses]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a company ID and UPKUAJING_API_KEY; successful shareholder queries include shareholder data and fee information.]
\n\n## Skill Version(s):
\n1.0.0 (source: server evidence and skill metadata)
\n\n## Ethical Considerations:
\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\nFile v1.0.0:requirements.txt\n\nhttpx>=0.23.0","readmeExcerpt":"Skill: Conduct global company-level lookup to retrieve shareholders, C-suite executives and multi-tier equity structure data from worldwide corporate databases.Generate full shareholder rosters including ownership ratios, share classes and hierarchical ownership chains via simple company ID searches.Investors, industryanalysts, sales teams and risk management specialists audit equity frameworks and pinpoint ultimate ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"cat ~/.upkuajing/.env"},{"language":"text","snippet":"UPKUAJING_API_KEY=your_api_key_here"},{"language":"bash","snippet":"python scripts/error_report.py --params '{\"requestPath\":\"/agent/search/depth_company/company/shareholder/list\",\"requestId\":\"f47ac10b58cc4372a5670e02b2c3d479\",\"context\":\"Shareholder list query failed with a server error\"}'"},{"language":"bash","snippet":"python scripts/company_shareholder_list.py --pid US_12345"},{"language":"bash","snippet":"cat ~/.upkuajing/.env"},{"language":"text","snippet":"UPKUAJING_API_KEY=your_api_key_here"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: global-company-shareholder\ndescription: \"Retrieve overseas shareholders, executives and ultimate beneficial owners by company ID. Analyze equity structure for due‑diligence, investment research and competitor background checks.\\n\\nTrigger: ultimate beneficial owner check, corporate equity structure lookup, overseas shareholder research, company due‑diligence, related‑party transaction screening, identify actual company controllers\"\nmetadata: {\"version\":\"1.0.4\",\"homepage\":\"https://www.upkuajing.com\",\"clawdbot\":{\"emoji\":\"🏛️\",\"requires\":{\"bins\":[\"python\"],\"env\":[\"UPKUAJING_API_KEY\"]},\"primaryEnv\":\"UPKUAJING_API_KEY\"}}\n---\n\n# Global Company Shareholder Query\n\nQuery shareholder data from the global company database (全球企业库) using the UpKuaJing Open Platform API.\n\n## Overview\n\nThis skill provides access to shareholder information from UpKuaJing's global company database. Given a company ID (pid), it returns the list of shareholders with their IDs, names, types, shareholding methods, and ratios.\n\n**Prerequisite**: The company ID (pid) is required as input. If the user does not already have a company ID, use the **global-company-search** skill first to search for the target company and obtain its pid, then proceed with this skill.\n\n## Running Scripts\n\n### Environment Setup\n\n1. **Check Python**: `python --version`\n2. **Install dependencies**: `pip install -r requirements.txt`\n\nScript directory: `scripts/*.py`\nRun example: `python scripts/*.py`\n\n**Important**: Always use direct script invocation like `python scripts/company_shareholder_list.py`. **Do NOT use** shell compound commands like `cd scripts && python company_shareholder_list.py`\n\n### Shareholder List Query (`company_shareholder_list.py`)\n- **Return granularity**: Each shareholder as one record\n- **Use cases**: Query shareholders of a specific company\n- **Example**:\n - \"Who are the shareholders of company US_12345?\"\n - \"Get shareholder details for pid US_12345\"\n- **Parameters**: See [Shareholder List API](references/company-shareholder-list-api.md)\n\n## API Key and Top-up\n\nThis skill requires an API key. The API key is stored in the `~/.upkuajing/.env` file:\n```bash\ncat ~/.upkuajing/.env\n```\n**Example file content**:\n```\nUPKUAJING_API_KEY=your_api_key_here\n```\n### **API Key Not Set**\nFirst check if the `~/.upkuajing/.env` file has UPKUAJING_API_KEY;\nIf UPKUAJING_API_KEY is not set, prompt the user to choose:\n1. User has one: User provides it (manually add to ~/.upkuajing/.env file)\n2. User doesn't have one: You can apply using the interface (`auth.py --new_key`), the new key will be automatically saved to ~/.upkuajing/.env\nWait for user selection;\n\n### **Account Top-up**\nWhen API response indicates insufficient balance, explain and guide user to top up:\n1. Create top-up order (`auth.py --new_rec_order`)\n2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;\n\n### **Get Account Information**\nUse this script to get"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn76ywjzma121r2rh959ejsf49834c6x\",\n \"slug\": \"global-company-shareholder\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1787562945783\n}"},{"path":"references/company-shareholder-list-api.md","content":"# 全球企业库股东列表 API 参考\n\n> 根据公司ID获取公司的股东信息。\n> 接口路径：`POST /agent/search/depth_company/company/shareholder/list`\n\n## python脚本参数\n\n- `--pid`：公司ID（必填），如 `US_12345`\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| pid | string | 是 | 公司ID |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：响应码，0 表示成功\n- msg（string）：响应消息\n- data：股东列表数据（见下）\n- fee：计费信息（apiCost 本次扣费、accountBalance 账户余额、uuid 调用标识）\n\n### data 字段\n\n- total（integer）：股东总数\n- list（array）：股东列表\n\n### list 股东字段\n\n- pid（string）：公司ID\n- shareholderId（string）：股东ID\n- shareholderName（string）：股东名称\n- shareholderType（integer）：股东类型\n- shareholderDirect（string）：持股方式（如 \"direct\"）\n- shareholderTotal（string）：持股比例（如 \"60.00%\"）"},{"path":"references/skill-error-report-api.md","content":"# Agent调用Skill异常上报 API 参考\n\n> 上报 Agent 调用 Skill 异常，用于平台侧问题追踪与优化。异常上报不产生查询费用。\n> 接口路径：`POST /agent/skill/error/report`\n> 鉴权：需要 Bearer 令牌（UPKUAJING_API_KEY）\n\n## python脚本参数\n\n- `--params`：JSON格式的上报参数（必填）\n- 未传 `skillId`/`skillVersion` 时，脚本会自动从当前 Skill 目录名与 SKILL.md 读取并填充\n- 必填参数：`skillId`、`skillVersion`、`requestId`、`requestPath`、`context`；其中 `requestId` 从出问题的请求响应（ApiResp.requestId）中获取\n\n## API请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| skillId | string | 是 | Skill 标识（最大128字符），如\"customs-analysis-area\" |\n| skillVersion | string | 是 | Skill 版本（最大32字符） |\n| agentName | string | 否 | Agent 名称（最大128字符） |\n| modelName | string | 否 | 模型名称（最大128字符） |\n| requestPath | string | 是 | 出问题的站内接口路径，以 / 开头（最大255字符），如\"/agent/customs/analysis/area\" |\n| requestId | string | 是 | 全请求唯一关联号（最大128字符），取失败请求响应中的 requestId |\n| requestTime | long | 否 | 请求发起时间戳（毫秒，≥0） |\n| requestParams | object | 否 | 请求参数（原始入参，敏感字段会自动脱敏；序列化后≤64KB） |\n| responseData | object | 否 | 响应数据（异常发生时的返回内容，敏感字段会自动脱敏；序列化后≤64KB） |\n| durationMs | long | 否 | 本次调用耗时（毫秒，≥0） |\n| context | string | 是 | 异常上下文（堆栈/错误信息，用于定位根因，最大2000字符） |\n\n## 响应数据\n\n### 外层结构\n\n- code（integer）：状态码，0 表示成功\n- msg（string）：提示信息\n- requestId（string）：全请求唯一关联号（32位无横线，与 MDC traceId 同值）\n\n### data 字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| reportId | long | 上报记录 ID |"},{"path":"skill-card.md","content":"## Description:\n\nRetrieves shareholder records and ownership details for a company ID from UpKuaJing's global company database.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[upkuajing](https://clawhub.ai/user/upkuajing)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nInvestors, industry analysts, sales teams, and risk management specialists use this skill to inspect shareholder rosters, ownership ratios, and related equity-structure details for due diligence, investment research, competitor analysis, and controller checks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill performs paid API calls and includes account top-up helper commands.\n\nMitigation: Before any fee-incurring call, inform the user that fees apply, check current pricing through the provided price source or price command, and wait for explicit confirmation in a separate response.\n\nRisk: The skill can read or write UPKUAJING_API_KEY in a local plaintext file at ~/.upkuajing/.env.\n\nMitigation: Prefer a safer secret mechanism such as an environment variable or secret manager; if the local file is used, ensure it is owner-only readable and never print its contents.\n\nRisk: Confirmed error reports are sent to the UpKuaJing platform and may include request context.\n\nMitigation: Submit error reports only after user confirmation and avoid including sensitive business, account, or credential data in report context.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/upkuajing/skills/global-company-shareholder)\n- [UpKuaJing Homepage](https://www.upkuajing.com)\n- [UpKuaJing Open Platform](https://developer.upkuajing.com/)\n- [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)\n- [Company Shareholder List API](references/company-shareholder-list-api.md)\n- [Skill Error Report API](references/skill-error-report-api.md)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Text, Shell commands, Guidance]\n\n**Output Format:** [JSON API responses with concise natural-language guidance and shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a company ID and UPKUAJING_API_KEY; successful shareholder queries include result data, fee details, and a request identifier.]\n\n## Skill Version(s):\n\n1.0.4 (source: frontmatter and server 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":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1596,"uniquenessScore":38,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T04:54:47.170Z","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-11T04:54:47.170Z","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-11T07:43:31.715Z","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"}]}}}