What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

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

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

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.2k

Updated

Oct 11, 2026

Version

1.0.4

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.2K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.4release · observed Aug 24, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:global-company-shareholder

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: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-global-company-shareholder/snapshot"

Documentation

CLAWHUB

60,615 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: global-company-shareholder
description: "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"
metadata: {"version":"1.0.4","homepage":"https://www.upkuajing.com","clawdbot":{"emoji":"🏛️","requires":{"bins":["python"],"env":["UPKUAJING_API_KEY"]},"primaryEnv":"UPKUAJING_API_KEY"}}
---

# Global Company Shareholder Query

Query shareholder data from the global company database (全球企业库) using the UpKuaJing Open Platform API.

## Overview

This 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.

**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.

## Running Scripts

### Environment Setup

1. **Check Python**: `python --version`
2. **Install dependencies**: `pip install -r requirements.txt`

Script directory: `scripts/*.py`
Run example: `python scripts/*.py`

**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`

### Shareholder List Query (`company_shareholder_list.py`)
- **Return granularity**: Each shareholder as one record
- **Use cases**: Query shareholders of a specific company
- **Example**:
  - "Who are the shareholders of company US_12345?"
  - "Get shareholder details for pid US_12345"
- **Parameters**: See [Shareholder List API](references/company-shareholder-list-api.md)

## API Key and Top-up

This skill requires an API key. The API key is stored in the `~/.upkuajing/.env` file:
```bash
cat ~/.upkuajing/.env
```
**Example file content**:
```
UPKUAJING_API_KEY=your_api_key_here
```
### **API Key Not Set**
First check if the `~/.upkuajing/.env` file has UPKUAJING_API_KEY;
If UPKUAJING_API_KEY is not set, prompt the user to choose:
1. User has one: User provides it (manually add to ~/.upkuajing/.env file)
2. 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
Wait for user selection;

### **Account Top-up**
When API response indicates insufficient balance, explain and guide user to top up:
1. Create top-up order (`auth.py --new_rec_order`)
2. Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;

### **Get Account Information**
Use this script to get

_meta.json

{
  "ownerId": "kn76ywjzma121r2rh959ejsf49834c6x",
  "slug": "global-company-shareholder",
  "version": "1.0.4",
  "publishedAt": 1787562945783
}

references/company-shareholder-list-api.md

# 全球企业库股东列表 API 参考

> 根据公司ID获取公司的股东信息。
> 接口路径：`POST /agent/search/depth_company/company/shareholder/list`

## python脚本参数

- `--pid`：公司ID（必填），如 `US_12345`

## API请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| pid | string | 是 | 公司ID |

## 响应数据

### 外层结构

- code（integer）：响应码，0 表示成功
- msg（string）：响应消息
- data：股东列表数据（见下）
- fee：计费信息（apiCost 本次扣费、accountBalance 账户余额、uuid 调用标识）

### data 字段

- total（integer）：股东总数
- list（array）：股东列表

### list 股东字段

- pid（string）：公司ID
- shareholderId（string）：股东ID
- shareholderName（string）：股东名称
- shareholderType（integer）：股东类型
- shareholderDirect（string）：持股方式（如 "direct"）
- shareholderTotal（string）：持股比例（如 "60.00%"）

references/skill-error-report-api.md

# Agent调用Skill异常上报 API 参考

> 上报 Agent 调用 Skill 异常，用于平台侧问题追踪与优化。异常上报不产生查询费用。
> 接口路径：`POST /agent/skill/error/report`
> 鉴权：需要 Bearer 令牌（UPKUAJING_API_KEY）

## python脚本参数

- `--params`：JSON格式的上报参数（必填）
- 未传 `skillId`/`skillVersion` 时，脚本会自动从当前 Skill 目录名与 SKILL.md 读取并填充
- 必填参数：`skillId`、`skillVersion`、`requestId`、`requestPath`、`context`；其中 `requestId` 从出问题的请求响应（ApiResp.requestId）中获取

## API请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| skillId | string | 是 | Skill 标识（最大128字符），如"customs-analysis-area" |
| skillVersion | string | 是 | Skill 版本（最大32字符） |
| agentName | string | 否 | Agent 名称（最大128字符） |
| modelName | string | 否 | 模型名称（最大128字符） |
| requestPath | string | 是 | 出问题的站内接口路径，以 / 开头（最大255字符），如"/agent/customs/analysis/area" |
| requestId | string | 是 | 全请求唯一关联号（最大128字符），取失败请求响应中的 requestId |
| requestTime | long | 否 | 请求发起时间戳（毫秒，≥0） |
| requestParams | object | 否 | 请求参数（原始入参，敏感字段会自动脱敏；序列化后≤64KB） |
| responseData | object | 否 | 响应数据（异常发生时的返回内容，敏感字段会自动脱敏；序列化后≤64KB） |
| durationMs | long | 否 | 本次调用耗时（毫秒，≥0） |
| context | string | 是 | 异常上下文（堆栈/错误信息，用于定位根因，最大2000字符） |

## 响应数据

### 外层结构

- code（integer）：状态码，0 表示成功
- msg（string）：提示信息
- requestId（string）：全请求唯一关联号（32位无横线，与 MDC traceId 同值）

### data 字段

| 字段 | 类型 | 说明 |
|------|------|------|
| reportId | long | 上报记录 ID |

skill-card.md

## Description:

Retrieves shareholder records and ownership details for a company ID from UpKuaJing's global company database.

This skill is ready for commercial/non-commercial use.

## Publisher:

[upkuajing](https://clawhub.ai/user/upkuajing)

### License/Terms of Use:

MIT-0

## Use Case:

Investors, 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.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill performs paid API calls and includes account top-up helper commands.

Mitigation: 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.

Risk: The skill can read or write UPKUAJING_API_KEY in a local plaintext file at ~/.upkuajing/.env.

Mitigation: 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.

Risk: Confirmed error reports are sent to the UpKuaJing platform and may include request context.

Mitigation: Submit error reports only after user confirmation and avoid including sensitive business, account, or credential data in report context.

## Reference(s):

- [ClawHub Skill Page](https://clawhub.ai/upkuajing/skills/global-company-shareholder)
- [UpKuaJing Homepage](https://www.upkuajing.com)
- [UpKuaJing Open Platform](https://developer.upkuajing.com/)
- [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)
- [Company Shareholder List API](references/company-shareholder-list-api.md)
- [Skill Error Report API](references/skill-error-report-api.md)

## Skill Output:

**Output Type(s):** [JSON, Text, Shell commands, Guidance]

**Output Format:** [JSON API responses with concise natural-language guidance and shell command examples]

**Output Parameters:** [1D]

**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.]

## Skill Version(s):

1.0.4 (source: frontmatter and server release evidence)

## Ethical Considerations:

Users 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.

Github ReposUpdated 1d agoRank 70

AionUi

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!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

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

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.