Xpersona
I

Identifies alumni connections from LinkedIn datasets using school-ID and personnel-IDinputs. It maps out alumni-related ties linked to individuals and educationalinstitutions. Recruiters, sales teams and B2B lead-generation specialists explore alumninetwo

CLAWHUB · Unverified

Find alumni connections via school ID and personnel ID from LinkedIn. Trace educational‑based networks to source talents and grow your B2B contact list. Trigger: LinkedIn alumni discovery, educational‑network mapping, alumni‑connection research, talent sourcing, B2B contact enrichment, institutional relationship analysis

62
Rank
84
Safety
996
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 996 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

Install and run

Setup complexity: low.

clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:linkedin-person-alumni
  1. Install using `clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:linkedin-person-alumni` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/upkuajing/linkedin-person-alumni before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-linkedin-person-alumni/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

47,789 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkedin-person-alumni
description: "Find alumni connections via school ID and personnel ID from LinkedIn. Trace educational‑based networks to source talents and grow your B2B contact list.\n\nTrigger: LinkedIn alumni discovery, educational‑network mapping, alumni‑connection research, talent sourcing, B2B contact enrichment, institutional relationship analysis"
metadata: {"version":"1.0.5","homepage":"https://www.upkuajing.com","clawdbot":{"emoji":"🎓","requires":{"bins":["python"],"env":["UPKUAJING_API_KEY"]},"primaryEnv":"UPKUAJING_API_KEY"}}
---

# LinkedIn Person Alumni Query

Query alumni data from LinkedIn using the UpKuaJing Open Platform API.

## Overview

This skill provides access to alumni information from UpKuaJing's LinkedIn data. Given a person ID (hid) and a school ID (sid), it returns the list of alumni with their person IDs and school IDs.

- The `hid` (person ID) can be obtained from **linkedin-person-search** (person search) results
- The `sid` (school ID) can be obtained from **linkedin-person-education** (education history query) results

## 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/linkedin_person_alumni_list.py`. **Do NOT use** shell compound commands like `cd scripts && python linkedin_person_alumni_list.py`

### Alumni List Query (`linkedin_person_alumni_list.py`)
- **Return granularity**: Each alumni as one record
- **Use cases**: Find alumni of a specific person from a specific school
- **Examples**:
  - "Find alumni of person H_67890 from school S_001"
  - "Get more alumni using the next page cursor"
- **Parameters**: See [Alumni List API](references/linkedin-person-alumni-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 account information for UPKUAJING_API_KEY: `auth.py --account_info`

## API Key and UpKuaJing Account
- Newly applied API key: Register and login at [

_meta.json

{
  "ownerId": "kn76ywjzma121r2rh959ejsf49834c6x",
  "slug": "linkedin-person-alumni",
  "version": "1.0.5",
  "publishedAt": 1787563700772
}

references/linkedin-person-alumni-list-api.md

# 领英校友列表 API 参考

> 根据人物ID和学校ID获取某人的校友信息，支持游标翻页。
> 接口路径：`POST /agent/search/linkedin/person/alumni/list`

## python脚本参数

- `--hid`：人物ID（必填），如 `H_67890`
- `--sid`：学校ID（必填），如 `S_001`
- `--cursor`：分页游标（可选），首次查询不传，翻页时传入上一次响应返回的cursor

## API请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| hid | string | 是 | 人物ID |
| sid | string | 是 | 学校ID |
| cursor | string | 否 | 分页游标，首次请求传空串，翻页时传入上一次响应返回的cursor |

## 响应数据

### 外层结构

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

### data 字段

- cursor（string）：下一页游标，为空表示无更多数据
- list（array）：校友列表

### list 校友字段

- sid（string）：学校ID
- hid（string）：人物ID

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:

Find alumni connections from LinkedIn data using a school ID and person ID to support alumni network research, talent sourcing, and B2B contact enrichment.

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

## Publisher:

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

### License/Terms of Use:

MIT-0

## Use Case:

Recruiters, sales teams, B2B lead-generation specialists, and agents acting for them use this skill to query alumni ties between a person and an educational institution, then page through returned alumni records for sourcing or relationship research.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill stores and reads an UpKuaJing API key from a home-directory environment file, and the security evidence warns against exposing that file.

Mitigation: Use a scoped secret mechanism for UPKUAJING_API_KEY, do not print the local environment file, and rotate the key if it is exposed.

Risk: The skill uses paid UpKuaJing API calls and can initiate account top-up flows.

Mitigation: Confirm each paid query or top-up action explicitly before execution, and check current pricing through the documented pricing flow.

Risk: The skill sends LinkedIn-related person and school identifiers, and optional error-report context, to a third-party service.

Mitigation: Share only the identifiers and diagnostic context needed for the request, and confirm error reporting before sending troubleshooting data.

## Reference(s):

- [LinkedIn Person Alumni List API](references/linkedin-person-alumni-list-api.md)
- [Skill Error Report API](references/skill-error-report-api.md)
- [ClawHub skill page](https://clawhub.ai/upkuajing/skills/linkedin-person-alumni)
- [UpKuaJing homepage](https://www.upkuajing.com)
- [UpKuaJing developer platform](https://developer.upkuajing.com/)
- [UpKuaJing API pricing](https://www.upkuajing.com/web/openapi/price.html)

## Skill Output:

**Output Type(s):** [guidance, shell commands, configuration, JSON]

**Output Format:** [Markdown guidance with inline shell commands and JSON API responses]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires an UPKUAJING_API_KEY; alumni queries are paid API calls and may use cursor-based pagination.]

## Skill Version(s):

1.0.5 (source: server evidence and frontmatter)

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

Sponsored

Ads related to Identifies alumni connections from LinkedIn datasets using school-ID and personnel-IDinputs. It maps out alumni-related ties linked to individuals and educationalinstitutions. Recruiters, sales teams and B2B lead-generation specialists explore alumninetwo and adjacent AI workflows.