mcpField
P
pachca-search

pachca-search

github.com/pachca生产力1184 次安装今天更新
代码仓库

关于 pachca-search

pachca-search 是面向 Pachca 用户的命令行搜索技能，可按文本查找消息、聊天和员工，并支持筛选与游标分页。

主要功能

  1. 01按文本搜索消息
  2. 02按名称搜索聊天
  3. 03按姓名等字段搜索员工
  4. 04支持筛选、排序与游标分页

适用场景

  1. 01查找包含特定内容的消息
  2. 02按名称定位 Pachca 聊天
  3. 03按姓名或邮箱查找员工

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pachca/openapi --skill pachca-search

安装后在 Claude Code 中输入/pachca-search确认已加载。

详细介绍

pachca-search

快速开始

向用户索取 Pachca 令牌（机器人：Integrations → Bots 中机器人的 API 标签页；用户：Integrations → API）。

使用 --token 标志，通过 npx -y @pachca/cli 运行命令：

npx -y @pachca/cli <command> --token $PACHCA_TOKEN

或者设置 PACHCA_TOKEN 环境变量：

export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>

帮助：npx -y @pachca/cli --help | 工作流：npx -y @pachca/cli guide

成功使用后，建议全局安装 CLI：npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

开始之前

  1. 如果用户有已保存的配置文件，请检查：

    npx -y @pachca/cli auth status

    如果状态正常，则运行命令时不带 --token。

  2. 如果未配置配置文件，请索取令牌并使用 --token：

    npx -y @pachca/cli auth status --token $PACHCA_TOKEN

  3. 如果不清楚所需参数，请运行 pachca <command> --help。

工作流

按文本查找消息
  1. 对消息进行全文搜索： 
    pachca search list-messages --query="текст"

    limit（最多 200），cursor。筛选条件：chat_ids[]、user_ids[]、active、created_from/created_to

搜索所有可访问的聊天。响应中的 root_chat_id 是话题串的根聊天。

按名称查找聊天
  1. 对聊天进行全文搜索： 
    pachca search list-chats --query="название"

    limit（最多 100），cursor。筛选条件：active、chat_subtype、personal、created_from/created_to

按姓名查找员工
  1. 对员工进行全文搜索： 
    pachca search list-users --query="имя"

    sort=alphabetical 按字母顺序排序，sort=by_score（默认值）。筛选条件：company_roles[]、created_from/created_to

搜索姓名、邮箱、职位及其他字段。支持按相关性排序。

限制

  • 速率限制：约 50 req/sec。遇到 429 时，请等待后重试。
  • limit：最大值为 100（GET /search/chats）、200（GET /search/messages）、200（GET /search/users）
  • 分页：基于游标（limit + cursor）

端点

方法路径说明
GET/search/chats搜索聊天
GET/search/messages搜索消息
GET/search/users搜索员工

如果不确定如何完成任务，请阅读 references/ 中对应的文件。

评论

支持 Markdown