flashid-auto 0.2.0__tar.gz

flashid_auto-0.2.0/.env.example

@@ -0,0 +1,7 @@
+FLASHID_API_BASE_URL=http://127.0.0.1:58931
+FLASHID_API_KEY=
+FLASHID_CONNECT_TIMEOUT=5
+FLASHID_READ_TIMEOUT=30
+FLASHID_BROWSER_TIMEOUT=180
+FLASHID_PROXY_TIMEOUT=65
+LINKEDIN_MCP_PROFILE=Navigator

flashid_auto-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 flashid-auto contributors
+
+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.

flashid_auto-0.2.0/MANIFEST.in

@@ -0,0 +1,14 @@
+include LICENSE
+include .env.example
+include requirements-dev.lock
+include requirements-mcp.lock
+include docs/package-readme.md
+include docs/linkedin-mcp.md
+include docs/linkedin-mcp-release.md
+include docs/linkedin-sales-navigator.md
+include docs/linkedin-people-search.md
+include docs/flashid-api-reference.md
+include docs/examples/linkedin-mcp-client.json
+include docs/examples/linkedin-mcp-server.template.json
+recursive-include tests *.py
+global-exclude __pycache__ *.py[cod] .env

flashid_auto-0.2.0/PKG-INFO

@@ -0,0 +1,130 @@
+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/examples/linkedin-mcp-client.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "linkedin-mcp": {
+      "command": "/absolute/path/to/flashid-auto/.venv/bin/linkedin-mcp",
+      "args": [
+        "--env-file", "/absolute/path/to/flashid-auto/.env",
+        "--profile", "Navigator"
+      ]
+    }
+  }
+}

flashid_auto-0.2.0/docs/examples/linkedin-mcp-server.template.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "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",
+  "repository": {
+    "url": "https://github.com/replace-owner/replace-repository",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "registryBaseUrl": "https://pypi.org",
+      "identifier": "flashid-auto",
+      "version": "0.2.0",
+      "runtimeHint": "uvx",
+      "runtimeArguments": [
+        {"type":"named","name":"--with","value":"flashid-auto[mcp]==0.2.0"}
+      ],
+      "packageArguments": [{"type":"positional","value":"mcp"}],
+      "transport": {"type":"stdio"},
+      "environmentVariables": [
+        {
+          "name":"FLASHID_API_BASE_URL",
+          "description":"Your FlashID Local API origin",
+          "default":"http://127.0.0.1:58931",
+          "isRequired":true
+        },
+        {
+          "name":"FLASHID_API_KEY",
+          "description":"Your own FlashID Local API key",
+          "isRequired":true,
+          "isSecret":true
+        },
+        {
+          "name":"LINKEDIN_MCP_PROFILE",
+          "description":"Name of your running FlashID environment",
+          "default":"Navigator",
+          "isRequired":true
+        }
+      ]
+    }
+  ]
+}