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

{flashid_auto-0.2.2/src/flashid_auto.egg-info → flashid_auto-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flashid-auto
-Version: 0.2.2
+Version: 0.2.3
 Summary: Modular automation for running FlashID browsers
 License-Expression: MIT
 Keywords: flashid,browser,automation,playwright

{flashid_auto-0.2.2 → flashid_auto-0.2.3}/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.2",
+  "version": "0.2.3",
   "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.2",
+      "version": "0.2.3",
       "runtimeHint": "uvx",
       "runtimeArguments": [
-        {"type":"named","name":"--with","value":"flashid-auto[mcp]==0.2.2"}
+        {"type":"named","name":"--with","value":"flashid-auto[mcp]==0.2.3"}
       ],
       "packageArguments": [{"type":"positional","value":"mcp"}],
       "transport": {"type":"stdio"},

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

@@ -1,6 +1,6 @@
 # LinkedIn MCP 使用与接口契约
 
-日期：2026-10-23。发行版本：flashid-auto 0.2.2。服务名和启动命令：`linkedin-mcp`。
+日期：2026-10-23。发行版本：flashid-auto 0.2.3。服务名和启动命令：`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.2' linkedin-mcp --profile Navigator
+codex mcp add linkedin-mcp --env FLASHID_API_KEY=YOUR_FLASHID_API_KEY -- uvx --from 'flashid-auto[mcp]==0.2.3' 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.2-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.3-py3-none-any.whl[mcp]' linkedin-mcp --profile Navigator
 ```
 
 命令中的 wheel 路径须替换为本机实际绝对路径。该方式不依赖 PyPI 上尚未发布的本项目。

{flashid_auto-0.2.2 → flashid_auto-0.2.3}/docs/linkedin-people-search.md

@@ -120,7 +120,7 @@ JSON 链见 [linkedin-company-people-search.json](examples/linkedin-company-peop
 
 单次输出为 `{"data":{},"records":[],"artifacts":[]}`。`data` 包含 `action`、`search_key`、`company_name`、`company_id`、`requested_filters`、`applied_filters`、`requested_count`、`collected_count`、`pages_visited`、`complete`、`search_url`、`result_count_text`。搜索还含 `require_result_count`、`result_count_met`，终止时含 `stop_reason`；检查时含 `filters`。
 
-每条人员记录包含 `rank`、`lead_id`、`name`、`url`、`title`、`company_name`、`company_url`、`location`、`tenure_text`、`about`、`connection_degree`、`recent_activity_text`、`badges`。`url` 优先使用 `https://www.linkedin.com/in/{slug}`；若详情面板无法提供有效公开链接，则使用 `https://www.linkedin.com/sales/lead/{id}`。回退链接只保留 lead ID，不带逗号后的路由附加信息、查询参数或片段；已在 `Navigator` 验证纯 ID 地址可正常打开。模块从列表卡片读取资料，直接点击员工姓名打开同一搜索页上的侧边详情面板，核对员工 ID 后等待异步加载的操作菜单按钮可见，再展开菜单、等待 “View LinkedIn profile” 链接可见并提取，最后关闭面板继续采集。面板框架先出现不代表员工资料已加载；菜单暂未出现时继续等待，达到配置超时仍不可用才回退。不会用 `page.goto()` 打开员工详情。缺失的可选字段为空字符串或空数组，按 lead ID 去重。
+每条人员记录包含 `rank`、`lead_id`、`name`、`url`、`title`、`company_name`、`company_url`、`location`、`tenure_text`、`about`、`connection_degree`、`recent_activity_text`、`badges`。`url` 优先使用 `https://www.linkedin.com/in/{slug}`；若详情面板无法提供有效公开链接，则使用 `https://www.linkedin.com/sales/lead/{id}`。回退链接只保留 lead ID，不带逗号后的路由附加信息、查询参数或片段；已在 `Navigator` 验证纯 ID 地址可正常打开。模块从列表卡片读取资料，直接点击员工姓名打开同一搜索页上的侧边详情面板，核对员工 ID 后等待异步加载的操作菜单或 “Unlock full profile” 状态：前者出现时展开菜单、等待 “View LinkedIn profile” 链接并提取；后者出现时立即使用 `/sales/lead/` 回退链接，不再等待公开链接。两者均未出现时达到配置超时后回退。最后关闭面板继续采集。不会用 `page.goto()` 打开员工详情。缺失的可选字段为空字符串或空数组，按 lead ID 去重。
 
 失败沿用框架 `MODULE_FAILED`，细分 `error.details.module_code`：`FILTER_UNAVAILABLE`、`FILTER_OPTION_NOT_FOUND`、`FILTER_NOT_APPLIED`、`PAGE_UNSUPPORTED`、`PAGINATION_STALLED`、`INSUFFICIENT_RESULTS`、`LOGIN_REQUIRED`、`SEARCH_CHALLENGE`、`SEARCH_TIMEOUT`、`SEARCH_FAILED`。Current company 无候选，或提供的公司 ID 无法精确匹配时返回 `FILTER_OPTION_NOT_FOUND`；`require_result_count=false` 仅允许人员结果正常耗尽时不足目标数，不会忽略公司筛选失败。公开链接缺失或无效，以及详情面板打开或菜单操作失败时，回退到 `/sales/lead/`，继续搜索。其他失败保留已解析人员的部分输出但 `complete=false`。参数与绑定预检错误为 `INVALID_PARAMS`。
 

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flashid-auto"
-version = "0.2.2"
+version = "0.2.3"
 description = "Modular automation for running FlashID browsers"
 readme = "docs/package-readme.md"
 license = "MIT"

{flashid_auto-0.2.2 → flashid_auto-0.2.3}/src/flashid_auto/modules/linkedin_people_search.py

@@ -188,14 +188,61 @@ class LeadSearchPage(SalesPage):
             header_id = re.match(r"^/sales/lead/([^,/]+)", header_path)
             if not header_id or header_id[1] != lead_url.rsplit("/", 1)[1]:
                 return lead_url
-            trigger = panel.get_by_role("button", name="Open actions overflow menu").first
             # The panel header renders before the asynchronously loaded lead details.
-            # Wait for the actual action control instead of treating its absence as final.
-            await trigger.wait_for(state="visible", timeout=optional_timeout)
+            # Wait for either the public-profile action or the account-gated unlock state.
+            state = await self.page.wait_for_function(
+                r"""selector => {
+                    const root = document.querySelector(selector);
+                    if (!root) return false;
+                    const visible = element => {
+                        const style = window.getComputedStyle(element);
+                        return style.display !== "none" &&
+                            style.visibility !== "hidden" &&
+                            !!(element.offsetWidth || element.offsetHeight ||
+                                element.getClientRects().length);
+                    };
+                    const controls = root.querySelectorAll("button, a, [role='button']");
+                    const unlock = Array.from(controls).some(element =>
+                        element.textContent.trim() === "Unlock full profile" && visible(element));
+                    const actions = Array.from(root.querySelectorAll(
+                        "[aria-label='Open actions overflow menu']"
+                    )).some(visible);
+                    if (unlock) return "unlock";
+                    return actions ? "actions" : false;
+                }""",
+                arg="#inline-sidesheet-outlet",
+                timeout=optional_timeout,
+            )
+            if await state.json_value() == "unlock":
+                await state.dispose()
+                return lead_url
+            await state.dispose()
+            trigger = None
+            triggers = panel.get_by_role("button", name="Open actions overflow menu", exact=True)
+            for index in range(await triggers.count()):
+                candidate = triggers.nth(index)
+                if await candidate.is_visible():
+                    trigger = candidate
+                    break
+            if trigger is None:
+                return lead_url
             await trigger.click(timeout=optional_timeout)
             link = self.page.get_by_role("link", name="View LinkedIn profile", exact=True)
-            await link.first.wait_for(timeout=optional_timeout)
-            return profile_url(await link.first.get_attribute("href")) or lead_url
+            await self.page.wait_for_function(
+                r"""() => Array.from(document.querySelectorAll("a")).some(element => {
+                    const style = window.getComputedStyle(element);
+                    return element.textContent.trim() === "View LinkedIn profile" &&
+                        style.display !== "none" && style.visibility !== "hidden" &&
+                        !!(element.offsetWidth || element.offsetHeight ||
+                            element.getClientRects().length);
+                })""",
+                timeout=optional_timeout,
+            )
+            for index in range(await link.count()):
+                candidate = link.nth(index)
+                if await candidate.is_visible():
+                    return profile_url(await candidate.get_attribute("href")) or lead_url
+            return lead_url
         except (PlaywrightError, ValueError):
             return lead_url
         finally:

{flashid_auto-0.2.2 → flashid_auto-0.2.3/src/flashid_auto.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flashid-auto
-Version: 0.2.2
+Version: 0.2.3
 Summary: Modular automation for running FlashID browsers
 License-Expression: MIT
 Keywords: flashid,browser,automation,playwright

{flashid_auto-0.2.2 → flashid_auto-0.2.3}/tests/test_linkedin_people_search.py

@@ -116,6 +116,7 @@ def people_html(
     profile_href=None,
     no_detail_panel=False,
     locked_profile=False,
+    unlock_full_profile=False,
     ambiguous_company=False,
     detail_delay_ms=0,
     menu_delay_ms=50,
@@ -157,7 +158,8 @@ def people_html(
     <script>
     const total=TOTAL, broken=BROKEN, missingCompany=MISSING_COMPANY;
     const profileHref=PROFILE_HREF_VALUE, noDetailPanel=NO_DETAIL_PANEL_VALUE;
-    const lockedProfile=LOCKED_PROFILE_VALUE, ambiguousCompany=AMBIGUOUS_COMPANY_VALUE;
+    const lockedProfile=LOCKED_PROFILE_VALUE, unlockFullProfile=UNLOCK_FULL_PROFILE_VALUE;
+    const ambiguousCompany=AMBIGUOUS_COMPANY_VALUE;
     const detailDelay=DETAIL_DELAY_VALUE, menuDelay=MENU_DELAY_VALUE;
     const noCompanyCandidates=NO_COMPANY_CANDIDATES_VALUE;
     let batch=0, revision=0;
@@ -239,11 +241,17 @@ def people_html(
       outlet.querySelector('[aria-label="Dismiss"]').onclick=()=>outlet.innerHTML='';
       setTimeout(()=>{
         if(!header.isConnected)return;
+        if(unlockFullProfile){
+          outlet.insertAdjacentHTML('beforeend','<button>Unlock full profile</button>');
+          return;
+        }
         if(lockedProfile)return;
         outlet.insertAdjacentHTML('beforeend',
+          '<button hidden aria-label="Open actions overflow menu">Actions</button>'+
           '<button aria-label="Open actions overflow menu">Actions</button>'+
-          (href?'<a hidden href="'+href+'">View LinkedIn profile</a>':''));
-        outlet.querySelector('[aria-label="Open actions overflow menu"]').onclick=()=>
+          (href?'<a hidden href="'+href+'">View LinkedIn profile</a>'+
+            '<a href="'+href+'">View LinkedIn profile</a>':''));
+        outlet.querySelectorAll('[aria-label="Open actions overflow menu"]')[1].onclick=()=>
           setTimeout(()=>{for(const a of outlet.querySelectorAll('a'))a.hidden=false},menuDelay);
       },detailDelay);
     }
@@ -269,6 +277,7 @@ def people_html(
         .replace("PROFILE_HREF_VALUE", json.dumps(profile_href))
         .replace("NO_DETAIL_PANEL_VALUE", "true" if no_detail_panel else "false")
         .replace("LOCKED_PROFILE_VALUE", "true" if locked_profile else "false")
+        .replace("UNLOCK_FULL_PROFILE_VALUE", "true" if unlock_full_profile else "false")
         .replace("AMBIGUOUS_COMPANY_VALUE", json.dumps(ambiguous_company))
         .replace("DETAIL_DELAY_VALUE", str(detail_delay_ms))
         .replace("MENU_DELAY_VALUE", str(menu_delay_ms))
@@ -544,6 +553,19 @@ def test_locked_profile_falls_back_after_configured_timeout():
     assert time.monotonic() - started < 5
 
 
+@pytest.mark.browser
+def test_unlock_full_profile_skips_public_profile_wait():
+    started = time.monotonic()
+    result = asyncio.run(
+        execute(
+            {"company_name": "Qualitrol", "result_count": 1, "timeout_ms": 5000},
+            html=people_html(total=1, unlock_full_profile=True, detail_delay_ms=100),
+        )
+    )
+    assert result["records"][0]["url"] == "https://www.linkedin.com/sales/lead/1"
+    assert time.monotonic() - started < 2
+
+
 @pytest.mark.browser
 @pytest.mark.parametrize("detail_delay,menu_delay", [(500, 50), (3300, 50), (50, 3300)])
 def test_public_profile_waits_for_delayed_details_and_menu(detail_delay, menu_delay):