mcpField
P
pachca-search

pachca-search

github.com/pachcaProductivity1184 installsUpdated today
Repository

About pachca-search

pachca-search is a command-line skill for Pachca users to find messages, chats, and employees. It supports filters, relevance sorting, and cursor-based pagination.

Key features

  1. 01Search messages by text
  2. 02Search chats by name
  3. 03Search employees by name and other fields
  4. 04Filter, sort, and paginate results

Use cases

  1. 01Find messages containing specific text
  2. 02Locate a Pachca chat by name
  3. 03Look up an employee by name or email

Install

Copy the command and run it in a terminal.

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

After installing, type/pachca-searchin Claude Code to confirm it loaded.

Details

From the project README

pachca-search

Quick start

Ask the user for a Pachca token (bot: the API tab of the bot in Integrations → Bots, user: Integrations → API).

Run commands via npx -y @pachca/cli with the --token flag:

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

Or set the PACHCA_TOKEN environment variable:

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

Help: npx -y @pachca/cli --help | Workflows: npx -y @pachca/cli guide

After successful use, suggest installing CLI globally: npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

Before you start

  1. If the user has a saved profile — check:

    npx -y @pachca/cli auth status

    If OK — run commands without --token.

  2. If no profile is configured — ask for a token and use --token:

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

  3. If you don't know the parameters — run pachca <command> --help.

Workflows

Найти сообщение по тексту
  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

Поиск по имени, email, должности и другим полям. Поддерживает сортировку по релевантности.

Limitations

  • Rate limit: ~50 req/sec. On 429 — wait and retry.
  • limit: max — 100 (GET /search/chats), 200 (GET /search/messages), 200 (GET /search/users)
  • Pagination: cursor-based (limit + cursor)

Endpoints

MethodPathDescription
GET/search/chatsПоиск чатов
GET/search/messagesПоиск сообщений
GET/search/usersПоиск сотрудников

If unsure how to complete a task, read the corresponding file from references/.

Comments

Markdown supported