📦 Hemlane MCP — Hemlane 物业管理平台(MCP)
v0.2.0使用HAR派生的GraphQL模式和浏览器会话工件来操作Hemlane。在分析Hemlane HAR文件、从He...中提取GraphQL操作时使用。
运行时依赖
安装命令
点击复制技能文档
使用此技能进行Hemlane逆向工程和可重复的浏览器捕获工作流。 包含HAR覆盖范围 在需要快速映射保存的Hemlane HAR文件内容时,请先阅读references/har-summary.md。 已保存的流程合并到此技能中: refer_hemlane.com.har tenant-reply_hemlane.com.har work-order_hemlane.com.har requests_hemlane.com.har transactions_hemlane.com.har maintenance_update_hemlane.com.har financials_hemlane.com.har(在~/Downloads/har运行时捕获,总结在references/financials-har-summary.md中) 默认工作流 确定需要哪种业务操作:推荐、租户回复、工作订单、请求、事务或维护更新。 阅读references/har-summary.md以找到最接近的HAR。 阅读references/graphql-operations.md以找到相关的GraphQL操作名称、变量和查询摘录。 如果需要从HAR文件中提取或规范化,请使用scripts/extract_hemlane_graphql.py。 更喜欢重建稳定的GraphQL请求而不是脆弱的浏览器点击。 保留身份验证和CSRF要求;永远不要将机密硬编码到技能中。 身份验证规则 将cookie、bearer令牌、CSRF令牌和会话标识符视为运行时机密。 不要在SKILL.md或references中存储实时令牌。 在重放捕获的请求时,使用环境变量或短暂的本地文件。 CDP身份验证捕获 使用scripts/capture_hemlane_auth_via_cdp.py通过CDP从经过身份验证的Brave浏览器会话中捕获新鲜的身份验证标头。 要求 Brave浏览器在启用远程调试(--remote-debugging-port=9222)时运行 浏览器中的Hemlane身份验证会话 使用 python3 skills/hemlane/scripts/capture_hemlane_auth_via_cdp.py \ --endpoint-kind get-properties \ --out-file /tmp/hemlane-auth.json 端点类型 get-properties - 属性列表 get-tenants - 租户列表 get-transactions - 财务事务 get-maintenance - 维护请求 send-tenant-reply - 租户消息 submit-referral - HubSpot推荐表单 work-order-comment - 工作订单评论 maintenance-comment - 维护评论 MCP服务器 Hemlane MCP服务器通过MCP协议提供常见操作工具。 位置 mcp/server.py - 包装现有脚本的FastMCP服务器 提供的工具 capture_auth - 从浏览器CDP捕获身份验证标头 send_tenant_reply - 发送租户回复 submit_referral - 提交推荐 post_workorder_comment - 发布工作订单评论 post_maintenance_comment - 发布维护评论 extract_rent_roll - 提取租金滚动数据 query_recurring_payment_requests - 查询Financials HAR样本中的活动/过期的周期性租金/付款请求 query_financials_operation - 从financials HAR样本中重放读取Financials GraphQL操作,包括页面导航 list_graphql_operations - 列出可用的GraphQL操作 配置 添加到config/mcporter.json: { "mcpServers": { "hemlane": { "command": "python3", "args": ["/home/umbrel/.openclaw/workspace/skills/hemlane/mcp/server.py"], "transport": "stdio" } } } 此技能擅长 将多个Hemlane HAR文件转换为一个操作参考 发现GraphQL操作名称和变量形状 从捕获的浏览器流量中重建Hemlane API请求 将未来的Hemlane自动化标准化为一个位置 文件 references/har-summary.md - 每个HAR库存和身份验证标头观察 references/graphql-operations.md - 提取的GraphQL操作和示例变量有效载荷 scripts/extract_hemlane_graphql.py - 可重用的HAR文件提取器 scripts/capture_hemlane_auth_via_cdp.py - 从浏览器的CDP身份验证捕获 mcp/server.py - MCP服务器用于工具访问 references/operation-catalog.json和references/operation-catalog.csv - 清洁的操作目录导出 references/runbooks.md - 显式的运行书用于推荐提交、租户回复、维护/工作订单评论和事务查找 references/*.har - 保留的原始Hemlane HAR捕获 scripts/build_hemlane_catalog.py - 从HAR文件重新生成目录 重放脚手架 使用references/replay-scaffold.md和scripts/replay_hemlane_graphql.py,当您需要从HAR分析转移到安全的请求重放时。 从--dry-run开始,并仅通过环境变量提供cookie/CSRF。 任务级包装器 使用这些包装器来获取最高价值的Hemlane工作流,然后再降级到通用的重放脚手架: scripts/submit_hemlane_referral.py scripts/post_hemlane_workorder_comment.py scripts/post_hemlane_maintenance_request_comment.py scripts/send_hemlane_tenant_reply.py scripts/capture_hemlane_auth_via_cdp.py 租赁生成突变 从lease_hemlane.com.har捕获: 操作类型 目的 ODCreateLeaseAgreement突变 为租户组创建租赁协议 ODCreateLeaseAgreementTemplate突变 从租赁创建电子签名包 ODLeaseAgreementRevertEsignPacket突变 撤消/取消电子签名包 创建租赁协议突变 ODCreateLeaseAgreement($input: LeaseAgreementCreateInput!