01

Установка и первый запуск

npm install --global textanalysis-tools
textanalysis frequency article.txt --language auto

# without global install
npx --yes textanalysis-tools frequency --text "alpha beta alpha"

Требуется Node.js 22.13 или новее. Пакет устанавливает команду textanalysis.

02

Восемь команд

textanalysis analyze

Bag of Words-анализ и показатели Ципфа

textanalysis frequency

Частотность слов

textanalysis density

Плотность слов и точных фраз

textanalysis compare

Сравнение двух источников

textanalysis ngram

Последовательности длиной n

textanalysis bow

Вектор Bag of Words

textanalysis tfidf

Веса TF-IDF для корпуса

textanalysis similarity

Косинусное сходство BoW или TF-IDF

03

Способы ввода

path.txt

Локальный UTF-8-файл передаётся позиционным аргументом.

--text "..."

Строка из аргумента командной строки.

--url https://...

Публичная HTTP/HTTPS-страница.

stdin

Конвейер или перенаправленный ввод.

cat article.txt | textanalysis ngram --size 2 --format csv
textanalysis compare draft.txt final.txt --format json
textanalysis tfidf a.txt b.txt c.txt --format json

04

Общие параметры

ПараметрНазначение
--languageauto, en, ru, uk, es
--keep-stopwordsОставить служебные слова
--formattable, json, csv
--topОграничить число строк

05

Форматы и коды завершения

Таблица предназначена для чтения в терминале, JSON — для скриптов, CSV — для таблиц и конвейеров. Код 0 означает успех, ненулевой код — ошибку аргументов, чтения, сети или анализа.

06

Локальная обработка и URL

Файлы, строка --text и stdin обрабатываются локально. URL требует сетевого запроса к указанной странице, но содержимое не сохраняется инструментом. Выбирайте локальный ввод для закрытых или неопубликованных материалов.

07

Локальный MCP для AI-агентов

Команда textanalysis mcp запускает stdio-сервер с восемью read-only tools, проверяемыми входными схемами и структурированными результатами.

npx --yes textanalysis-tools@0.2.0 mcp

Открыть руководство для агентов

HTTP · OPENAPI

Когда выбрать API

Используйте API, если анализ должен выполняться на сервере приложения или нужен стабильный HTTP-контракт.

Открыть документацию API