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 alumninetworks, track educational-background connections and build expanded contact databases.This tool works well for talent sourcing, institutional-network research and B2Blead-generation workflows.

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.4","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 [UpKuaJing Open Platform](https://developer.upkuajing.com/), then bind account

## Fees

**All API calls incur fees**, different interfaces have different billing methods.

**Latest pricing**: Users can visit [Detailed Price Description](https://www.upkuajing.com/web/openapi/price.html)
Or use: `python scripts/auth.py --price_info` (returns complete pricing for all interfaces)

### Query Billing Rules

Billed by **number of calls**, each call returns one page of alumni records:
- Each API call incurs a fee
- Use `--cursor` to get additional pages (each page is a separate call)
- **Before execution:**
  1. Inform user that this query will incur a fee
  2. Stop, wait for explicit user confirmation in a separate message, then execute script

### Fee Confirmation Principle

**Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.**

## Workflow

### Decision Guide

| User Intent | Use API |
|-------------|---------|
| "Find alumni of person H_67890 from school S_001" | Alumni List Query |

## Usage Examples

### Query Alumni List

**User request**: "Find alumni of person H_67890 from school S_001"
```bash
python scripts/linkedin_person_alumni_list.py --hid H_67890 --sid S_001
```

**Get next page** (use cursor returned from previous response):
```bash
python scripts/linkedin_person_alumni_list.py --hid H_67890 --sid S_001 --cursor 'cursor_string_from_previous_response'
```

## Error Handling

- **API key invalid/non-existent**: Check `UPKUAJING_API_KEY` in `~/.upkuajing/.env` file
- **Insufficient balance**: Guide user to top up
- **Invalid parameters**: **Must first check the corresponding API documentation in references/ directory**, get correct parameter names and formats from documentation, do not guess

### API Documentation Reference

- Alumni List: Check [references/linkedin-person-alumni-list-api.md](references/linkedin-person-alumni-list-api.md)

## Best Practices

1. **Check API documentation**:
   - **Before executing queries, must first check the corresponding API reference documentation**
   - Check [references/linkedin-person-alumni-list-api.md](references/linkedin-person-alumni-list-api.md)
   - Do not guess parameter names, get accurate parameter names and formats from documentation

2. **Pagination**:
   - When the response returns a non-empty `cursor`, more data is available
   - Pass the `cursor` value to get the next page
   - An empty `cursor` means there is no more data

3. **Cross-skill usage**:
   - The `sid` (school ID) can be obtained from **linkedin-person-education** (education history query) results
   - The `hid` (person ID) can be obtained from **linkedin-person-search** (person search) results

## Notes
- Alumni records use `hid` as the person unique identifier; `sid` is the school identifier
- File paths use forward slashes on all platforms
- **Prohibit outputting technical parameter format**: Do not display code-style parameters in responses, convert to natural language
- **Do not** estimate or guess per-call fees — use `python scripts/auth.py --price_info` to get accurate pricing information
- **Do not** guess parameter names, get accurate parameter names and formats from documentation

## Related Skills

Other UpKuaJing skills you might find useful:

- linkedin-person-search — Search people from LinkedIn data
- linkedin-person-education — Query education history list from LinkedIn data
- linkedin-company-search — Search companies from LinkedIn data
- global-company-person-alumni — Query alumni list from the global company database
- linkedin-person-colleague — Query colleague list from LinkedIn data
- global-company-person-search — Search people from the global company database
- upkuajing-global-company-people-search — Unified company and people search across all sources
- upkuajing-contact-info-validity-check — Check contact info validity
- phone-validity-check — Check phone number validity
- email-validity-check — Check email address validity
- domain-validity-check — Check domain validity and security- upkuajing-email-tool — Email verification and sending tool
- upkuajing-sms-tool — SMS tool