flashid-auto 0.2.0__tar.gz → 0.2.2__tar.gz

flashid_auto-0.2.2/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: flashid-auto
+Version: 0.2.2
+Summary: Modular automation for running FlashID browsers
+License-Expression: MIT
+Keywords: flashid,browser,automation,playwright
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.32.3
+Requires-Dist: python-dotenv<2,>=1.0.1
+Requires-Dist: playwright<2,>=1.51
+Requires-Dist: jsonschema<5,>=4.23
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8.3; extra == "dev"
+Requires-Dist: requests-mock<2,>=1.12; extra == "dev"
+Requires-Dist: ruff<1,>=0.11; extra == "dev"
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.3; extra == "mcp"
+Requires-Dist: filelock<4,>=3.18; extra == "mcp"
+Provides-Extra: release
+Requires-Dist: build<2,>=1.2; extra == "release"
+Requires-Dist: twine<8,>=6; extra == "release"
+Dynamic: license-file
+
+# FlashID Auto
+
+A Python automation tool for FlashID browsers. Connect to an existing, running
+FlashID browser environment, execute modular browser tasks, and receive
+structured JSON results.
+
+## Features
+
+- Connect to FlashID through its Local API and an existing browser's CDP endpoint.
+- Run browser automation modules using Playwright.
+- Execute individual modules or chain multiple steps with JSON data bindings.
+- Return structured results, execution status, and error details.
+- Clean up task-created tabs during normal completion while preserving existing tabs.
+- Extend automation with custom Python modules.
+
+## Requirements
+
+- Python 3.10 or later.
+- FlashID with Local API enabled.
+- A running FlashID browser environment for browser tasks.
+
+Playwright connects to FlashID's existing browser, so no separate Chromium
+download is required for these tasks.
+
+## Installation
+
+```bash
+python -m pip install flashid-auto
+```
+
+## Configuration
+
+Set the following environment variables, or create a `.env` file in your working
+directory:
+
+```dotenv
+FLASHID_API_BASE_URL=http://127.0.0.1:58931
+FLASHID_API_KEY=YOUR_FLASHID_API_KEY
+```
+
+Use your own FlashID API key and keep the `.env` file private. Existing process
+environment variables take precedence over values in the file.
+
+## Usage
+
+Check the FlashID Local API connection:
+
+```bash
+flashid health
+```
+
+Run a browser automation task in the running environment named `Navigator`:
+
+```bash
+flashid-auto --profile Navigator --module duckduckgo -- \
+  --search-key "FlashID browser automation" --result-count 3
+```
+
+Use the exact name of your running FlashID environment for `--profile`.
+Commands return JSON that can be consumed by scripts and other automation tools.
+
+For multi-step tasks, supply a JSON execution plan:
+
+```bash
+flashid-auto --profile Navigator --chain-file tasks.json
+```
+
+See `flashid-auto --help` and `flashid --help` for command-line options.
+
+## License
+
+MIT. This project is independent of FlashID.

{flashid_auto-0.2.0 → flashid_auto-0.2.2}/docs/examples/linkedin-mcp-server.template.json

@@ -3,7 +3,7 @@
   "name": "io.github.replace-owner/linkedin-mcp",
   "title": "LinkedIn MCP for FlashID",
   "description": "Search LinkedIn Sales Navigator companies and employees in your own FlashID browser.",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "repository": {
     "url": "https://github.com/replace-owner/replace-repository",
     "source": "github"
@@ -13,10 +13,10 @@
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "flashid-auto",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "runtimeHint": "uvx",
       "runtimeArguments": [
-        {"type":"named","name":"--with","value":"flashid-auto[mcp]==0.2.0"}
+        {"type":"named","name":"--with","value":"flashid-auto[mcp]==0.2.2"}
       ],
       "packageArguments": [{"type":"positional","value":"mcp"}],
       "transport": {"type":"stdio"},

{flashid_auto-0.2.0 → flashid_auto-0.2.2}/docs/linkedin-mcp.md

@@ -1,6 +1,6 @@
 # LinkedIn MCP 使用与接口契约
 
-日期：2026-10-20。发行版本：flashid-auto 0.2.0。服务名和启动命令：`linkedin-mcp`。
+日期：2026-10-23。发行版本：flashid-auto 0.2.2。服务名和启动命令：`linkedin-mcp`。
 公司模块复用 `linkedin_sales_navigator` 1.2.0，人员模块复用 `linkedin_people_search` 2.3.0。
 
 ## 1. 目标与安装
@@ -46,7 +46,7 @@ Windows 使用 `.venv\Scripts\python.exe` 和 `.venv\Scripts\linkedin-mcp.exe`
 目前发行包仍为本地构建，尚未公开上传。**
 
 ```bash
-codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from 'flashid-auto[mcp]==0.2.0' linkedin-mcp --profile Navigator
+codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from 'flashid-auto[mcp]==0.2.2' linkedin-mcp --profile Navigator
 ```
 
 将 `YOUR_FLASHID_API_KEY` 替换为用户自己的 Key。`codex mcp add` 保存 MCP 启动配置；
@@ -62,7 +62,7 @@ Codex 首次连接时，`uvx` 自动下载依赖、缓存独立环境并启动
 发布前可以直接用本地 wheel 验证：
 
 ```bash
-codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from '/absolute/path/to/flashid_auto-0.2.0-py3-none-any.whl[mcp]' linkedin-mcp --profile Navigator
+codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from '/absolute/path/to/flashid_auto-0.2.2-py3-none-any.whl[mcp]' linkedin-mcp --profile Navigator
 ```
 
 命令中的 wheel 路径须替换为本机实际绝对路径。该方式不依赖 PyPI 上尚未发布的本项目。
@@ -100,9 +100,9 @@ MCP 人员搜索要求 `company_name`、`company_id` 同时提供，同时不接
 
 ## 3. 自然语言调用流程
 
-1. 调用 `check_environment`。若未运行、未登录或遇到人工验证，提示用户恢复环境。
+1. 不把 `check_environment` 作为例行前置步骤；仅在用户明确要求检查环境，或搜索出现环境／登录故障时调用。
 2. 从用户请求提取关键词和条件，不添加用户未指定的 Persona、活跃度或业务画像。
-3. 对动态地区、行业、职位、列表等先 inspect；使用页面候选原文。
+3. 对请求中无法从已有结果核实的动态地区、行业、职位、列表等调用 inspect；使用页面候选原文，不为例行探测调用 inspect。
 4. 区分公司总部与员工所在地；人数档位无法精确表达、币种不明时先澄清。
 5. 按已核实条件搜索；“最多 N 条”使用 `require_result_count=false`，“需要 N 条”保留 true。
 6. 公司→人员场景按公司顺序调用 `search_people`，携带名称和 ID，保留来源公司关联。

flashid_auto-0.2.2/docs/package-readme.md

@@ -0,0 +1,72 @@
+# FlashID Auto
+
+A Python automation tool for FlashID browsers. Connect to an existing, running
+FlashID browser environment, execute modular browser tasks, and receive
+structured JSON results.
+
+## Features
+
+- Connect to FlashID through its Local API and an existing browser's CDP endpoint.
+- Run browser automation modules using Playwright.
+- Execute individual modules or chain multiple steps with JSON data bindings.
+- Return structured results, execution status, and error details.
+- Clean up task-created tabs during normal completion while preserving existing tabs.
+- Extend automation with custom Python modules.
+
+## Requirements
+
+- Python 3.10 or later.
+- FlashID with Local API enabled.
+- A running FlashID browser environment for browser tasks.
+
+Playwright connects to FlashID's existing browser, so no separate Chromium
+download is required for these tasks.
+
+## Installation
+
+```bash
+python -m pip install flashid-auto
+```
+
+## Configuration
+
+Set the following environment variables, or create a `.env` file in your working
+directory:
+
+```dotenv
+FLASHID_API_BASE_URL=http://127.0.0.1:58931
+FLASHID_API_KEY=YOUR_FLASHID_API_KEY
+```
+
+Use your own FlashID API key and keep the `.env` file private. Existing process
+environment variables take precedence over values in the file.
+
+## Usage
+
+Check the FlashID Local API connection:
+
+```bash
+flashid health
+```
+
+Run a browser automation task in the running environment named `Navigator`:
+
+```bash
+flashid-auto --profile Navigator --module duckduckgo -- \
+  --search-key "FlashID browser automation" --result-count 3
+```
+
+Use the exact name of your running FlashID environment for `--profile`.
+Commands return JSON that can be consumed by scripts and other automation tools.
+
+For multi-step tasks, supply a JSON execution plan:
+
+```bash
+flashid-auto --profile Navigator --chain-file tasks.json
+```
+
+See `flashid-auto --help` and `flashid --help` for command-line options.
+
+## License
+
+MIT. This project is independent of FlashID.

{flashid_auto-0.2.0 → flashid_auto-0.2.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flashid-auto"
-version = "0.2.0"
+version = "0.2.2"
 description = "Modular automation for running FlashID browsers"
 readme = "docs/package-readme.md"
 license = "MIT"
 license-files = ["LICENSE"]
-keywords = ["mcp", "linkedin", "sales-navigator", "flashid", "automation"]
+keywords = ["flashid", "browser", "automation", "playwright"]
 requires-python = ">=3.10"
 dependencies = [
     "requests>=2.32.3,<3",

{flashid_auto-0.2.0 → flashid_auto-0.2.2}/src/flashid_auto/mcp/tools.py

@@ -9,9 +9,13 @@ from flashid_auto.modules.linkedin_people_search import LinkedInPeopleSearchModu
 from flashid_auto.modules.linkedin_sales_navigator import LinkedInSalesNavigatorModule
 
 INSTRUCTIONS = """Search LinkedIn Sales Navigator in the user's existing FlashID browser.
-Interpret the user's natural language and call the structured tools. Start with
-check_environment. Discover dynamic filter values with inspect tools; never invent
-LinkedIn option names or IDs. Company headquarters and employee geography differ.
+Interpret the user's natural language and call the structured tools. Do not call
+check_environment as a routine preflight or health check; use it only when the user
+explicitly asks for an environment/access check or when diagnosing an environment
+failure. Keep inspect_company_filters available, but do not call it as a routine
+preflight. Use an inspect tool only when the requested dynamic filter value or ID
+cannot be verified from the request or prior tool output; never invent LinkedIn option
+names or IDs. Company headquarters and employee geography differ.
 Do not add unspecified business conditions. Clarify ambiguous companies, currencies,
 and ranges that cannot be represented exactly. For a company-specific people search,
 obtain company_name and company_id from search_companies or from

flashid_auto-0.2.2/src/flashid_auto.egg-info/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: flashid-auto
+Version: 0.2.2
+Summary: Modular automation for running FlashID browsers
+License-Expression: MIT
+Keywords: flashid,browser,automation,playwright
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.32.3
+Requires-Dist: python-dotenv<2,>=1.0.1
+Requires-Dist: playwright<2,>=1.51
+Requires-Dist: jsonschema<5,>=4.23
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8.3; extra == "dev"
+Requires-Dist: requests-mock<2,>=1.12; extra == "dev"
+Requires-Dist: ruff<1,>=0.11; extra == "dev"
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.3; extra == "mcp"
+Requires-Dist: filelock<4,>=3.18; extra == "mcp"
+Provides-Extra: release
+Requires-Dist: build<2,>=1.2; extra == "release"
+Requires-Dist: twine<8,>=6; extra == "release"
+Dynamic: license-file
+
+# FlashID Auto
+
+A Python automation tool for FlashID browsers. Connect to an existing, running
+FlashID browser environment, execute modular browser tasks, and receive
+structured JSON results.
+
+## Features
+
+- Connect to FlashID through its Local API and an existing browser's CDP endpoint.
+- Run browser automation modules using Playwright.
+- Execute individual modules or chain multiple steps with JSON data bindings.
+- Return structured results, execution status, and error details.
+- Clean up task-created tabs during normal completion while preserving existing tabs.
+- Extend automation with custom Python modules.
+
+## Requirements
+
+- Python 3.10 or later.
+- FlashID with Local API enabled.
+- A running FlashID browser environment for browser tasks.
+
+Playwright connects to FlashID's existing browser, so no separate Chromium
+download is required for these tasks.
+
+## Installation
+
+```bash
+python -m pip install flashid-auto
+```
+
+## Configuration
+
+Set the following environment variables, or create a `.env` file in your working
+directory:
+
+```dotenv
+FLASHID_API_BASE_URL=http://127.0.0.1:58931
+FLASHID_API_KEY=YOUR_FLASHID_API_KEY
+```
+
+Use your own FlashID API key and keep the `.env` file private. Existing process
+environment variables take precedence over values in the file.
+
+## Usage
+
+Check the FlashID Local API connection:
+
+```bash
+flashid health
+```
+
+Run a browser automation task in the running environment named `Navigator`:
+
+```bash
+flashid-auto --profile Navigator --module duckduckgo -- \
+  --search-key "FlashID browser automation" --result-count 3
+```
+
+Use the exact name of your running FlashID environment for `--profile`.
+Commands return JSON that can be consumed by scripts and other automation tools.
+
+For multi-step tasks, supply a JSON execution plan:
+
+```bash
+flashid-auto --profile Navigator --chain-file tasks.json
+```
+
+See `flashid-auto --help` and `flashid --help` for command-line options.
+
+## License
+
+MIT. This project is independent of FlashID.

flashid_auto-0.2.0/PKG-INFO

@@ -1,130 +0,0 @@
-Metadata-Version: 2.4
-Name: flashid-auto
-Version: 0.2.0
-Summary: Modular automation for running FlashID browsers
-License-Expression: MIT
-Keywords: mcp,linkedin,sales-navigator,flashid,automation
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests<3,>=2.32.3
-Requires-Dist: python-dotenv<2,>=1.0.1
-Requires-Dist: playwright<2,>=1.51
-Requires-Dist: jsonschema<5,>=4.23
-Provides-Extra: dev
-Requires-Dist: pytest<9,>=8.3; extra == "dev"
-Requires-Dist: requests-mock<2,>=1.12; extra == "dev"
-Requires-Dist: ruff<1,>=0.11; extra == "dev"
-Provides-Extra: mcp
-Requires-Dist: mcp<3,>=2.3; extra == "mcp"
-Requires-Dist: filelock<4,>=3.18; extra == "mcp"
-Provides-Extra: release
-Requires-Dist: build<2,>=1.2; extra == "release"
-Requires-Dist: twine<8,>=6; extra == "release"
-Dynamic: license-file
-
-# LinkedIn MCP for FlashID
-
-Search LinkedIn Sales Navigator companies and employees from a natural-language
-request in any MCP-compatible agent. The agent interprets your request and calls
-five structured tools in your existing FlashID browser.
-
-The MCP server and executable are named **linkedin-mcp**. The Python distribution
-is **flashid-auto**; the unrelated `linkedin-mcp` package on PyPI is not this project.
-
-## Install from source
-
-Requires Python 3.10+, FlashID with Local API enabled, and a running browser
-environment signed in to LinkedIn Sales Navigator (English interface).
-
-```bash
-python -m venv .venv
-.venv/bin/python -m pip install '.[mcp]'
-```
-
-On Windows, use `.venv\Scripts\python.exe` and `.venv\Scripts\linkedin-mcp.exe`.
-Playwright connects to FlashID's existing browser; no separate Chromium download
-is needed for actual searches.
-
-Copy `.env.example` to `.env` and fill in your FlashID API address and key.
-Keep your real `.env` private. Configuration can also be supplied as process
-environment variables. The MCP server does not require a separate LLM API key.
-
-## Connect an agent
-
-### Codex: one-command setup after PyPI publication
-
-With Codex CLI and uv (`uvx`) already installed, register the server:
-
-```bash
-codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from 'flashid-auto[mcp]==0.2.0' linkedin-mcp --profile Navigator
-```
-
-Replace the placeholder with your own FlashID API key. Codex saves the launch
-configuration; `uvx` installs and caches the package when Codex first connects.
-The default FlashID API address is `http://127.0.0.1:58931`. If needed, add
-`--env FLASHID_API_BASE_URL=http://your-host:port` before `--`.
-FlashID and the named browser environment must already be running and signed in.
-No source checkout, manual virtual environment, or JSON editing is needed.
-
-This command downloads version 0.2.0 from PyPI. For an unpublished build, use the
-source installation instructions above. Check configured servers with
-`codex mcp list`, then use `/mcp` inside Codex to inspect the connection.
-
-See the [official Codex MCP documentation](https://developers.openai.com/codex/mcp/).
-
-### Other MCP clients or installation from source
-
-Use absolute paths in your MCP client's configuration:
-
-```json
-{
-  "mcpServers": {
-    "linkedin-mcp": {
-      "command": "/absolute/path/to/project/.venv/bin/linkedin-mcp",
-      "args": [
-        "--env-file", "/absolute/path/to/project/.env",
-        "--profile", "Navigator"
-      ]
-    }
-  }
-}
-```
-
-Start FlashID and the named browser environment, sign in to Sales Navigator,
-then connect your agent. Each user supplies their own FlashID environment and
-LinkedIn session. The package shares the tools, not an account or browser session.
-
-Example requests:
-
-- “Find up to 10 companies headquartered in the United States related to substations.”
-- “Find procurement managers at this company.”
-- “Find five matching companies, then up to three purchasing contacts at each.”
-
-The agent can use `check_environment`, `inspect_company_filters`,
-`search_companies`, `inspect_people_filters`, and `search_people`.
-For a company-specific people search, it must supply both the verified company
-name and ID; discovery returns company IDs where the page exposes them.
-
-The server reads visible pages, creates temporary tabs, and cleans up its tabs.
-It preserves existing user tabs. It returns actual filters, counts and completion
-status, including valid partial results on failure. It stops for login or manual
-verification challenges. It does not save accounts, send messages, or write CRM data.
-
-The default module timeout is 300 seconds and the default per-page operation
-timeout is 15 seconds. Search calls sharing an environment run sequentially;
-overlapping MCP calls return `ENV_BUSY`.
-
-## Install a published release
-
-The distribution name is `flashid-auto`. Do not install the unrelated
-`linkedin-mcp` distribution as a substitute. To install version 0.2.0 from PyPI:
-
-```bash
-python -m pip install 'flashid-auto[mcp]==0.2.0'
-```
-
-The source tree contains the full Chinese integration guide at
-`docs/linkedin-mcp.md` and the release procedure at `docs/linkedin-mcp-release.md`.
-
-License: MIT. This project is independent of LinkedIn and FlashID.

flashid_auto-0.2.0/docs/package-readme.md

@@ -1,105 +0,0 @@
-# LinkedIn MCP for FlashID
-
-Search LinkedIn Sales Navigator companies and employees from a natural-language
-request in any MCP-compatible agent. The agent interprets your request and calls
-five structured tools in your existing FlashID browser.
-
-The MCP server and executable are named **linkedin-mcp**. The Python distribution
-is **flashid-auto**; the unrelated `linkedin-mcp` package on PyPI is not this project.
-
-## Install from source
-
-Requires Python 3.10+, FlashID with Local API enabled, and a running browser
-environment signed in to LinkedIn Sales Navigator (English interface).
-
-```bash
-python -m venv .venv
-.venv/bin/python -m pip install '.[mcp]'
-```
-
-On Windows, use `.venv\Scripts\python.exe` and `.venv\Scripts\linkedin-mcp.exe`.
-Playwright connects to FlashID's existing browser; no separate Chromium download
-is needed for actual searches.
-
-Copy `.env.example` to `.env` and fill in your FlashID API address and key.
-Keep your real `.env` private. Configuration can also be supplied as process
-environment variables. The MCP server does not require a separate LLM API key.
-
-## Connect an agent
-
-### Codex: one-command setup after PyPI publication
-
-With Codex CLI and uv (`uvx`) already installed, register the server:
-
-```bash
-codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from 'flashid-auto[mcp]==0.2.0' linkedin-mcp --profile Navigator
-```
-
-Replace the placeholder with your own FlashID API key. Codex saves the launch
-configuration; `uvx` installs and caches the package when Codex first connects.
-The default FlashID API address is `http://127.0.0.1:58931`. If needed, add
-`--env FLASHID_API_BASE_URL=http://your-host:port` before `--`.
-FlashID and the named browser environment must already be running and signed in.
-No source checkout, manual virtual environment, or JSON editing is needed.
-
-This command downloads version 0.2.0 from PyPI. For an unpublished build, use the
-source installation instructions above. Check configured servers with
-`codex mcp list`, then use `/mcp` inside Codex to inspect the connection.
-
-See the [official Codex MCP documentation](https://developers.openai.com/codex/mcp/).
-
-### Other MCP clients or installation from source
-
-Use absolute paths in your MCP client's configuration:
-
-```json
-{
-  "mcpServers": {
-    "linkedin-mcp": {
-      "command": "/absolute/path/to/project/.venv/bin/linkedin-mcp",
-      "args": [
-        "--env-file", "/absolute/path/to/project/.env",
-        "--profile", "Navigator"
-      ]
-    }
-  }
-}
-```
-
-Start FlashID and the named browser environment, sign in to Sales Navigator,
-then connect your agent. Each user supplies their own FlashID environment and
-LinkedIn session. The package shares the tools, not an account or browser session.
-
-Example requests:
-
-- “Find up to 10 companies headquartered in the United States related to substations.”
-- “Find procurement managers at this company.”
-- “Find five matching companies, then up to three purchasing contacts at each.”
-
-The agent can use `check_environment`, `inspect_company_filters`,
-`search_companies`, `inspect_people_filters`, and `search_people`.
-For a company-specific people search, it must supply both the verified company
-name and ID; discovery returns company IDs where the page exposes them.
-
-The server reads visible pages, creates temporary tabs, and cleans up its tabs.
-It preserves existing user tabs. It returns actual filters, counts and completion
-status, including valid partial results on failure. It stops for login or manual
-verification challenges. It does not save accounts, send messages, or write CRM data.
-
-The default module timeout is 300 seconds and the default per-page operation
-timeout is 15 seconds. Search calls sharing an environment run sequentially;
-overlapping MCP calls return `ENV_BUSY`.
-
-## Install a published release
-
-The distribution name is `flashid-auto`. Do not install the unrelated
-`linkedin-mcp` distribution as a substitute. To install version 0.2.0 from PyPI:
-
-```bash
-python -m pip install 'flashid-auto[mcp]==0.2.0'
-```
-
-The source tree contains the full Chinese integration guide at
-`docs/linkedin-mcp.md` and the release procedure at `docs/linkedin-mcp-release.md`.
-
-License: MIT. This project is independent of LinkedIn and FlashID.

flashid_auto-0.2.0/src/flashid_auto.egg-info/PKG-INFO

@@ -1,130 +0,0 @@
-Metadata-Version: 2.4
-Name: flashid-auto
-Version: 0.2.0
-Summary: Modular automation for running FlashID browsers
-License-Expression: MIT
-Keywords: mcp,linkedin,sales-navigator,flashid,automation
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests<3,>=2.32.3
-Requires-Dist: python-dotenv<2,>=1.0.1
-Requires-Dist: playwright<2,>=1.51
-Requires-Dist: jsonschema<5,>=4.23
-Provides-Extra: dev
-Requires-Dist: pytest<9,>=8.3; extra == "dev"
-Requires-Dist: requests-mock<2,>=1.12; extra == "dev"
-Requires-Dist: ruff<1,>=0.11; extra == "dev"
-Provides-Extra: mcp
-Requires-Dist: mcp<3,>=2.3; extra == "mcp"
-Requires-Dist: filelock<4,>=3.18; extra == "mcp"
-Provides-Extra: release
-Requires-Dist: build<2,>=1.2; extra == "release"
-Requires-Dist: twine<8,>=6; extra == "release"
-Dynamic: license-file
-
-# LinkedIn MCP for FlashID
-
-Search LinkedIn Sales Navigator companies and employees from a natural-language
-request in any MCP-compatible agent. The agent interprets your request and calls
-five structured tools in your existing FlashID browser.
-
-The MCP server and executable are named **linkedin-mcp**. The Python distribution
-is **flashid-auto**; the unrelated `linkedin-mcp` package on PyPI is not this project.
-
-## Install from source
-
-Requires Python 3.10+, FlashID with Local API enabled, and a running browser
-environment signed in to LinkedIn Sales Navigator (English interface).
-
-```bash
-python -m venv .venv
-.venv/bin/python -m pip install '.[mcp]'
-```
-
-On Windows, use `.venv\Scripts\python.exe` and `.venv\Scripts\linkedin-mcp.exe`.
-Playwright connects to FlashID's existing browser; no separate Chromium download
-is needed for actual searches.
-
-Copy `.env.example` to `.env` and fill in your FlashID API address and key.
-Keep your real `.env` private. Configuration can also be supplied as process
-environment variables. The MCP server does not require a separate LLM API key.
-
-## Connect an agent
-
-### Codex: one-command setup after PyPI publication
-
-With Codex CLI and uv (`uvx`) already installed, register the server:
-
-```bash
-codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from 'flashid-auto[mcp]==0.2.0' linkedin-mcp --profile Navigator
-```
-
-Replace the placeholder with your own FlashID API key. Codex saves the launch
-configuration; `uvx` installs and caches the package when Codex first connects.
-The default FlashID API address is `http://127.0.0.1:58931`. If needed, add
-`--env FLASHID_API_BASE_URL=http://your-host:port` before `--`.
-FlashID and the named browser environment must already be running and signed in.
-No source checkout, manual virtual environment, or JSON editing is needed.
-
-This command downloads version 0.2.0 from PyPI. For an unpublished build, use the
-source installation instructions above. Check configured servers with
-`codex mcp list`, then use `/mcp` inside Codex to inspect the connection.
-
-See the [official Codex MCP documentation](https://developers.openai.com/codex/mcp/).
-
-### Other MCP clients or installation from source
-
-Use absolute paths in your MCP client's configuration:
-
-```json
-{
-  "mcpServers": {
-    "linkedin-mcp": {
-      "command": "/absolute/path/to/project/.venv/bin/linkedin-mcp",
-      "args": [
-        "--env-file", "/absolute/path/to/project/.env",
-        "--profile", "Navigator"
-      ]
-    }
-  }
-}
-```
-
-Start FlashID and the named browser environment, sign in to Sales Navigator,
-then connect your agent. Each user supplies their own FlashID environment and
-LinkedIn session. The package shares the tools, not an account or browser session.
-
-Example requests:
-
-- “Find up to 10 companies headquartered in the United States related to substations.”
-- “Find procurement managers at this company.”
-- “Find five matching companies, then up to three purchasing contacts at each.”
-
-The agent can use `check_environment`, `inspect_company_filters`,
-`search_companies`, `inspect_people_filters`, and `search_people`.
-For a company-specific people search, it must supply both the verified company
-name and ID; discovery returns company IDs where the page exposes them.
-
-The server reads visible pages, creates temporary tabs, and cleans up its tabs.
-It preserves existing user tabs. It returns actual filters, counts and completion
-status, including valid partial results on failure. It stops for login or manual
-verification challenges. It does not save accounts, send messages, or write CRM data.
-
-The default module timeout is 300 seconds and the default per-page operation
-timeout is 15 seconds. Search calls sharing an environment run sequentially;
-overlapping MCP calls return `ENV_BUSY`.
-
-## Install a published release
-
-The distribution name is `flashid-auto`. Do not install the unrelated
-`linkedin-mcp` distribution as a substitute. To install version 0.2.0 from PyPI:
-
-```bash
-python -m pip install 'flashid-auto[mcp]==0.2.0'
-```
-
-The source tree contains the full Chinese integration guide at
-`docs/linkedin-mcp.md` and the release procedure at `docs/linkedin-mcp-release.md`.
-
-License: MIT. This project is independent of LinkedIn and FlashID.