Metadata-Version: 2.4
Name: bach-fresh_linkedin_profile_data
Version: 2.0.0
Summary: RapidAPI: freshdata-freshdata-default/fresh-linkedin-profile-data
Project-URL: Homepage, https://github.com/bachstudio/bach-fresh_linkedin_profile_data
Project-URL: Repository, https://github.com/bachstudio/bach-fresh_linkedin_profile_data
Project-URL: Bug Tracker, https://github.com/bachstudio/bach-fresh_linkedin_profile_data/issues
Project-URL: Documentation, https://github.com/bachstudio/bach-fresh_linkedin_profile_data#readme
Author: bachstudio
License: MIT License
        
        Copyright (c) 2025 bachstudio
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: api,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.25.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Fresh Linkedin Profile Data MCP Server

[English](./README_EN.md) | 简体中文 | [繁體中文](./README_ZH-TW.md)

## 🚀 使用 EMCP 平台快速体验

**[EMCP](https://sit-emcp.kaleido.guru)** 是一个强大的 MCP 服务器管理平台，让您无需手动配置即可快速使用各种 MCP 服务器！

### 快速开始：

1. 🌐 访问 **[EMCP 平台](https://sit-emcp.kaleido.guru)**
2. 📝 注册并登录账号
3. 🎯 进入 **MCP 广场**，浏览所有可用的 MCP 服务器
4. 🔍 搜索或找到本服务器（`bach-fresh_linkedin_profile_data`）
5. 🎉 点击 **"安装 MCP"** 按钮
6. ✅ 完成！即可在您的应用中使用

### EMCP 平台优势：

- ✨ **零配置**：无需手动编辑配置文件
- 🎨 **可视化管理**：图形界面轻松管理所有 MCP 服务器
- 🔐 **安全可靠**：统一管理 API 密钥和认证信息
- 🚀 **一键安装**：MCP 广场提供丰富的服务器选择
- 📊 **使用统计**：实时查看服务调用情况

立即访问 **[EMCP 平台](https://sit-emcp.kaleido.guru)** 开始您的 MCP 之旅！


---

## 简介

这是一个 MCP 服务器，用于访问 Fresh Linkedin Profile Data API。

- **PyPI 包名**: `bach-fresh_linkedin_profile_data`
- **版本**: 2.0.0
- **传输协议**: stdio


## 安装

### 从 PyPI 安装:

```bash
pip install bach-fresh_linkedin_profile_data
```

### 从源码安装:

```bash
pip install -e .
```

## 运行

### 方式 1: 使用 uvx（推荐，无需安装）

```bash
# 运行（uvx 会自动安装并运行）
uvx --from bach-fresh_linkedin_profile_data bach_fresh_linkedin_profile_data

# 或指定版本
uvx --from bach-fresh_linkedin_profile_data@latest bach_fresh_linkedin_profile_data
```

### 方式 2: 直接运行（开发模式）

```bash
python server.py
```

### 方式 3: 安装后作为命令运行

```bash
# 安装
pip install bach-fresh_linkedin_profile_data

# 运行（命令名使用下划线）
bach_fresh_linkedin_profile_data
```

## 配置

### API 认证

此 API 需要认证。请设置环境变量:

```bash
export API_KEY="your_api_key_here"
```

### 环境变量

| 变量名 | 说明 | 必需 |
|--------|------|------|
| `API_KEY` | API 密钥 | 是 |
| `PORT` | 不适用 | 否 |
| `HOST` | 不适用 | 否 |



### 在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件 `claude_desktop_config.json`:


```json
{
  "mcpServers": {
    "fresh_linkedin_profile_data": {
      "command": "uvx",
      "args": ["--from", "bach-fresh_linkedin_profile_data", "bach_fresh_linkedin_profile_data"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}
```

**注意**: 请将 `E:\path\to\fresh_linkedin_profile_data\server.py` 替换为实际的服务器文件路径。


## 可用工具

此服务器提供以下工具:


### `get_company_by_url`

1 credit per call.

**端点**: `GET /get-company-by-linkedinurl`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/company/apple/



---


### `enrich_lead`

1 credit per call. Using each extra option will cost another 0.5 credits. Maximum: 3 credits.

**端点**: `GET /enrich-lead`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/cjfollini/

- `include_skills` (string): Example value: 

- `include_certifications` (string): Example value: 

- `include_publications` (string): Example value: 

- `include_honors` (string): Example value: 

- `include_volunteers` (string): Example value: 

- `include_projects` (string): Example value: 

- `include_patents` (string): Example value: 

- `include_courses` (string): Example value: 

- `include_organizations` (string): Example value: 

- `include_profile_status` (string): Example value: 

- `include_company_public_url` (string): Example value: 



---


### `get_company_by_id`

1 credit per call.

**端点**: `GET /get-company-by-id`


**参数**:

- `company_id` (string) *必需*: Example value: 162479



---


### `find_custom_headcount`

Discover the count of employees within a specific company who meet designated criteria. 1 credit per call.

**端点**: `POST /find-custom-headcount`



---


### `count__job_openings`

Get the number of job openings a company has posted on LinkedIn. 1 credit per call.

**端点**: `GET /get-company-jobs-count`


**参数**:

- `company_id` (string) *必需*: Example value: 162479



---


### `google_profiles`

**2** credits per call.

**端点**: `POST /google-profiles`



---


### `get_profile_pdf_cv`

**1 credit per call.**

**端点**: `GET /get-profile-pdf-cv`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/williamhgates/



---


### `get_open_to_work_status`

**1 credit per call.**

**端点**: `GET /get-opentowork-status`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/williamhgates/



---


### `search_companies`

Step 1: Use this endpoint to make a search using your criteria. This endpoint will return a \

**端点**: `POST /search-companies`



---


### `get_search_results`

Get search results. Please make sure the search is \

**端点**: `GET /get-search-results`


**参数**:

- `request_id` (string) *必需*: Example value: dd1b29063de8927b31fa523d36432b61

- `page` (string) *必需*: Example value: 1



---


### `search_leads`

Find and scrape lead details with advanced filters.

**端点**: `POST /search-employees`



---


### `search_posts`

2 credits per call.

**端点**: `POST /search-posts`



---


### `get_posts_reactions`

1 credit per call.

**端点**: `GET /get-post-reactions`


**参数**:

- `urn` (string) *必需*: Example value: 7267273010393358336

- `type` (string): Default value: ALL. Possible values: ALL,LIKE,EMPATHY,APPRECIATION,INTEREST,PRAISE.

- `page` (string): Example value: 1



---


### `get_posts_comments`

1 credit per call.

**端点**: `GET /get-post-comments`


**参数**:

- `urn` (string) *必需*: Example value: 7267273010393358336

- `sort_by` (string): Default value: Most relevant. Possible values: Most relevant, Most recent.

- `page` (string): Example value: 1

- `pagination_token` (string): Example value: 



---


### `get_profile_latest_post_date`

Find out when he/she posted recently.

**端点**: `GET /profile-latest-post-date`


**参数**:

- `linkedin_url` (string): Example value: https://www.linkedin.com/in/ajjames/



---


### `detect_activity_time`

Get the time of the latest profile activity. 2 credits per call.

**端点**: `GET /get-profile-recent-activity-time`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/williamhgates/



---


### `search_decision_makers`

Search for decision makers of any company.

**端点**: `POST /search-decision-makers`



---


### `lead_search_at_scale`

Find and scrape leads at scale

**端点**: `POST /big-search-employee`



---


### `search_jobs_v2`

Using a simpler payload. 1 credit per call.

**端点**: `POST /search-jobs-v2`



---


### `check_search_status`

Get the status of your search using the request_id given in step 1.

**端点**: `GET /check-search-status`


**参数**:

- `request_id` (string) *必需*: Example value: dd1b29063de8927b31fa523d36432b61



---


### `get_post_details`

Scrape details of a single post based on its URN.

**端点**: `GET /get-post-details`


**参数**:

- `urn` (string) *必需*: Example value: 7315779816467656705



---


### `get_job_details`

Scrape the full job details, including the company basic information. 1 credit per call.

**端点**: `GET /get-job-details`


**参数**:

- `job_url` (string) *必需*: Example value: https://www.linkedin.com/jobs/view/3766410207/

- `include_skills` (string): Including skills will cost 1 more credit

- `include_hiring_team` (string): Including hiring team information will cost 1 more credit



---


### `get_companys_posts`

2 credits per call.

**端点**: `GET /get-company-posts`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/company/amazon/

- `start` (string): Use this param to fetch posts of the next result page: 0 for page 1, 50 for page 2, etc.

- `pagination_token` (string): Required when fetching the next result page. Please use the token from the result of your previous call.

- `sort_by` (string): Possible values: top, recent



---


### `get_companies`

Get search results. Please make sure the search is \

**端点**: `GET /get-search-companies-results`


**参数**:

- `request_id` (string) *必需*: Example value: ba072fac0b38d12378ef5023742f0184s34e1i8n2a7p0m9o

- `page` (string): Example value: 1



---


### `check_company_search_status`

Get the status of your search using the request_id given in step 1.

**端点**: `GET /check-search-companies-status`


**参数**:

- `request_id` (string) *必需*: Example value: ba072fac0b38d12378ef5023742f0184s34e1i8n2a7p0m9o



---


### `search_companies_by_sn_url`

Provide URL instead of filters.

**端点**: `POST /search-companies-by-sales-nav-url`



---


### `search_jobs`

To scrape all results from each search, change the parameter \

**端点**: `POST /search-jobs`



---


### `get_company_insights`

5 credits per call.

**端点**: `GET /get-company-insights`


**参数**:

- `company_id` (string) *必需*: Example value: 1035



---


### `get_profiles_posts`

2 credits per call

**端点**: `GET /get-profile-posts`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/williamhgates/

- `type` (string): Possible values: posts: to scrape posts from tab Posts -- posts or posts reshared by the person comments: to scrape posts from tab Comments -- posts the person commented reactions: to scrape posts from tab Reactions -- posts the person reacted

- `start` (string): Use this param to fetch posts of the next result page: 0 for page 1, 50 for page 2, etc.

- `pagination_token` (string): Required when fetching the next result page. Please use the token from the result of your previous call.



---


### `get_company_by_domain`

1 credit per call.

**端点**: `GET /get-company-by-domain`


**参数**:

- `domain` (string) *必需*: Example value: apple.com



---


### `search_linkedin_school_pages_via_google`

Find up to 100 schools that match your criteria via Google. **2** credits per call.

**端点**: `POST /google-schools`



---


### `search_linkedin_company_pages_via_google`

Find up to 100 companies that match your criteria via Google. **2** credits per call.

**端点**: `POST /google-companies`



---


### `get_years_of_experience`

Get the total number of years of experience of a profile.

**端点**: `GET /get-year-of-experiences`


**参数**:

- `linkedin_url` (string): Example value: https://www.linkedin.com/in/williamhgates/



---


### `get_recommendation_received`

Get profile’s recommendations (received). **1 credit per call**.

**端点**: `GET /get-recommendations-received`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/ajjames



---


### `search_companies_instantly`

Search companies in our cached database of 64 million records (updated annually). Instant results. Cost: 1 credit for 10 companies (searches returning fewer than 10 results still consume 1 credit).

**端点**: `POST /search-companies-instantly`



---


### `get_recommendation_given`

Get profile’s recommendations (given). **1 credit per call**.

**端点**: `GET /get-recommendations-given`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/ajjames



---


### `search_leads_v2`

Provide search url instead of filters

**端点**: `POST /search-employees-by-sales-nav-url`



---


### `get_open_profile_status`

**1 credit per call.**

**端点**: `GET /get-open-profile-status`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/williamhgates/



---


### `get_extra_profile_data`

Get more profile’s data fields like languages, top skills, certifications, publications, patents, awards

**端点**: `GET /get-extra-profile-data`


**参数**:

- `linkedin_url` (string) *必需*: Example value: https://www.linkedin.com/in/ajjames/



---



## 技术栈

- **传输协议**: stdio
- **HTTP 客户端**: httpx

## 开发

此服务器由 [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) 工具自动生成。

版本: 2.0.0
