Użyj tego narzędzia, aby wyszukać tablice, dokumenty lub foldery na swoim koncie monday.com za pomocą słowa kluczowego. Możesz ograniczyć wyszukiwanie do wybranych obszarów roboczych, używając workspaceIds. Wyniki są podzielone na strony i ograniczone do 20 na stronę.

To narzędzie obsługuje trzy typy treści: BOARD, DOCUMENTS i FOLDERS. Do wyszukiwania innych obiektów - użytkowników i zespołów, obszarów roboczych, elementów i grup - użyj odpowiednich narzędzi (list_users_and_teams, list_workspaces, get_board_items_page, get_board_info).

Parametry

Parametr	Typ	Wymagany	Opis
searchType	string	Tak	Typ obiektów do wyszukania. Jedna z wartości: BOARD, DOCUMENTS lub FOLDERS.
searchTerm	string	Nie	Słowo kluczowe, którego chcesz wyszukać. Pomiń ten parametr lub przekaż pusty ciąg znaków, aby zwrócić wszystkie obiekty danego typu.
limit	number	Nie	Liczba wyników zwracanych na stronę. Wartość domyślna i maksymalna to 20.
page	number	Nie	Numer strony do zwrócenia, zaczynając od 1. Domyślnie 1.
workspaceIds	array	Nie	Tablica identyfikatorów obszarów roboczych, które mają ograniczyć zakres wyszukiwania. Przekaż ten parametr tylko wtedy, gdy chcesz ograniczyć wyniki do wybranych obszarów roboczych.

Przykłady

Wyszukiwanie tablic według słowa kluczowego

Wyszukaj tablice zawierające słowo „test” w obszarze roboczym 12406666:

{
  "searchType": "BOARD",
  "searchTerm": "test",
  "limit": 5,
  "workspaceIds": [12406666]
}

Narzędzie zwróciło 5 pasujących tablic. Każdy wynik zawiera identyfikator id z prefiksem (np. "board-18394529013") i title. Usuń prefiks board-, aby uzyskać 18394529013. Możesz przekazać go bezpośrednio do get_board_info lub innych narzędzi.

Wyszukiwanie dokumentów według słowa kluczowego

Wyszukaj dokumenty zawierające „MCP” w obszarze roboczym 12406666:

{
  "searchType": "DOCUMENTS",
  "searchTerm": "MCP",
  "workspaceIds": [12406666]
}

Wyniki zawierają identyfikatory dokumentów w formacie doc-<id>. Usuń prefiks doc-, zanim przekażesz identyfikator do read_docs.

Wyświetlanie wszystkich folderów w obszarze roboczym

{
  "searchType": "FOLDERS",
  "searchTerm": "",
  "workspaceIds": [12406666]
}

Narzędzie zwróciło foldery o identyfikatorach takich jak "folder-19028717". Usuń prefiks folder-, zanim przekażesz identyfikator do narzędzi, które przyjmują identyfikatory folderów.

---

Odpowiednik programistyczny

Użyj GraphQL API, aby uzyskać ten sam wynik podczas wyszukiwania tablic:

query {
  boards(
    workspace_ids: [12406666]
    limit: 5
  ) {
    id
    name
    url
  }
}

Pełną dokumentację znajdziesz w sekcji Tablice.