# Search Records

> Search records in a NocoDB table by keyword Arguments: <table-name> <query>.

- Skill: `agents-store/search-records` (Agent Skill)
- Install (CLI): `npx get-skill add agents-store/search-records`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agents-store/search-records/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agents-store (https://skillmd.com/u/agents-store)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/agents-store/search-records

---


# Search Records

Search for records containing a keyword across text fields.

The filter and where syntax, operators and sorting are written down in `${CLAUDE_PLUGIN_ROOT}/skills/search-filter/SKILL.md`; read it before the first step.

## Arguments

Parse from "$ARGUMENTS":
- `table-name` (required): Name or ID of the table
- `query` (required): Search text to find

## Process

1. Run `getTablesList` to resolve the table name to an ID.
2. Run `getTableSchema` to identify text fields (SingleLineText, LongText, Email, URL, PhoneNumber).
3. Build a `where` filter using `like` operator across text fields combined with `~or`.
4. Run `queryRecords` with the constructed filter.
5. Display matching records in a formatted table.

## Example Usage

```
/search-records Contacts "john doe"
/search-records Orders "pending"
/search-records Products "widget"
```
