upstash-search-js — скилл для Claude Code: поиск на @upstash/search
Скилл ведёт агента по TypeScript SDK @upstash/search: индексы, документы, keyword, semantic и hybrid-запросы. Пригодится, когда в проект нужно добавить поиск.
npx skills add upstash/skills --skill upstash-search-js -a claude-codeЧто делает upstash-search-js
Скилл описывает работу с @upstash/search — серверлесс-базой полнотекстового и семантического поиска со встроенным реранкингом. Агент получает готовые шаблоны кода: создать клиент, открыть индекс, залить документы, выполнить запрос.
Внутри два набора инструкций. sdk-overview разбирает команды SDK: upsert, search, fetch, delete, range, reset, info. quick-start проводит весь путь от создания базы до выдачи результатов и объясняет разницу между content и metadata — первое ищется, второе фильтруется. Там же синтаксис фильтров и типичные ошибки.
Для работы нужны UPSTASH_SEARCH_REST_URL и UPSTASH_SEARCH_REST_TOKEN в переменных окружения, а сам SDK ставится через npm install @upstash/search. Без этих двух значений клиент не создастся, поэтому проверьте .env до того, как просить агента писать код поиска.
Какие задачи решает
- подключить поиск к сайту без своего кластера
- создать индекс и залить в него документы
- разделить поля на искомые и фильтруемые
- сделать semantic-запрос с реранкингом
- разбить выдачу на страницы через range
Примеры запросов агенту
- добавь поиск по документации на @upstash/search, индекс docs
- настрой hybrid-поиск по товарам с фильтром по категории
- покажи, как удалить документ из индекса и сбросить его
Как установить upstash-search-js
1Через Skills CLI (Vercel)
npx skills add upstash/skills --skill upstash-search-js -a claude-code2Вручную: положить файлы
~/.claude/skills/upstash-search-js/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/upstash-search-js/
1Через Skills CLI (Vercel)
npx skills add upstash/skills --skill upstash-search-js -a codex2Вручную: положить файлы
.agents/skills/upstash-search-js/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add upstash/skills --skill upstash-search-js -a cursor2Вручную: положить файлы
.cursor/skills/upstash-search-js/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install upstash/skills upstash-search-js2Вручную: положить файлы
.github/skills/upstash-search-js/SKILL.md1Через Skills CLI (Vercel)
npx skills add upstash/skills --skill upstash-search-js -a gemini-cli2Командой платформы
gemini skills install https://github.com/upstash/skills --path skills/upstash-search-jsВручную: положить файлы
.devin/skills/upstash-search-js/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add upstash/skills --skill upstash-search-js -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора10
Похожие
Рядом в теме «Данные и базы»
Все скиллы по теме «Данные и базы» →Вопросы о upstash-search-js
Как установить upstash-search-js в Claude?
Выполните npx skills add upstash/skills --skill upstash-search-js -a claude-code. Скилл окажется в ~/.claude/skills/upstash-search-js/SKILL.md.
Что делает upstash-search-js?
Даёт агенту документацию по TypeScript SDK @upstash/search: создание индекса, загрузка документов, keyword, semantic и hybrid-запросы, фильтры, пагинация.
Что нужно, чтобы скилл заработал?
Установленный @upstash/search и переменные окружения UPSTASH_SEARCH_REST_URL и UPSTASH_SEARCH_REST_TOKEN.
Исходный текст
SKILL.md · MIT
---
name: upstash-search-js
description: Work with the @upstash/search TypeScript/JavaScript SDK, a serverless full-text and semantic search database with built-in reranking. Use when adding search to an app or site, creating a search index, upserting documents with searchable content and filterable metadata, running keyword, semantic, or hybrid search queries, reranking results, filtering with SQL-like or structured filter syntax, paginating with range, fetching or deleting documents, resetting an index, or checking index info. Also use when the user asks for site search, product, document, or knowledge-base search, or a managed search service that needs no cluster to run.
license: MIT
metadata:
author: Upstash
homepage: https://upstash.com
---
# Upstash Search Documentation
## Quick Start
Install the TS SDK:
```
npm install @upstash/search
```
Create a client and perform a simple upsert + search:
```
import { Search } from "@upstash/search";
const client = new Search({ url: process.env.UPSTASH_SEARCH_REST_URL, token: process.env.UPSTASH_SEARCH_REST_TOKEN });
const index = client.index("my-index");
await index.upsert({ id: "1", content: { text: "hello world" } });
const results = await index.search({ query: "hello" });
```
Basic steps:
- Create an index
- Insert or update documents
- Run searches or filtered queries
## Other Skill Files
### sdk-overview
Provides detailed documentation for all TypeScript SDK commands. Includes:
- delete: Deleting documents
- fetch: Retrieving a document
- info: Index info
- range: Range queries
- reset: Clearing an index
- search: Search queries
- upsert: Adding/updating documents
- getting-started: Setup steps for the SDK
### quick-start
Provides a fast, end-to-end workflow for creating a Search database, adding documents, and querying them. Covers essential concepts including:
- Creating a database and storing credentials
- Adding documents with content and metadata
- Understanding content vs metadata (searchability and filterability)
- Performing searches with optional reranking
- Filtering syntax with SQL-like or structured filters
- Common pitfalls and best practices
© Upstash · MIT · upstash/skills