Local Falcon MCP Server

Локальный сервер Falcon MCP

Сервер MCP (Model Context Protocol) для Local Falcon API , реализованный на TypeScript с использованием официального MCP SDK. Этот сервер предоставляет возможности создания отчетов Local Falcon в качестве инструментов MCP, обеспечивая интеграцию с агентскими системами ИИ и рабочими процессами.

Предпосылки

• Node.js (установить версию LTS)

Начало работы в Claude Desktop

1. Создайте новый каталог для сервера MCP и установите пакет.

2. Скопируйте путь к установленному модулю npm и добавьте его в аргументы в файле mcp.json, убедившись, что он указывает на файл index.js в каталоге /dist.
3. Добавьте свой ключ API в env в файле mcp.json.

Запуск через STDIO

Для MacOS/Unix используйте следующий формат:

Для Windows используйте следующий формат:

Запуск через SSE через шлюз STDIO

Для всех платформ используйте следующий формат:

Профессиональные пользователи

Для пользователей Claude Max/Team вы разблокируете больший лимит вызова инструмента MCP. Это должно быть включено путем добавления is_pro=true в строку запроса URL. Например:

Работает через Claude Integrations (SSE)

При подключении к интеграции Claude:

1. имя сервера Local Falcon MCP
2. добавьте следующий URL: https://mcp.localfalcon.com/sse?local\_falcon\_api\_key=YOUR\_API\_KEY\_HERE

Список инструментов

• listLocalFalconScanReports: получает список всех отчетов о сканировании, выполненных вашей учетной записью Local Falcon.
• listLocalFalconTrendReports: извлекает список всех отчетов о тенденциях, созданных вашей учетной записью Local Falcon.
• listLocalFalconAutoScans: извлекает список всех автоматических сканирований.
• listAllLocalFalconLocations: получает список всех местоположений.
• listLocalFalconLocationReports: извлекает список всех отчетов о местоположении.
• getLocalFalconLocationReport: Получает один отчет о местоположении. Отчет о местоположении выглядит как https://www.localfalcon.com/reports/location/view/c60c325a8665c4a , где c60c325a8665c4a — ключ отчета.
• getLocalFalconReport: Извлекает один отчет о сканировании Local Falcon по ключу отчета. Читает только анализ AI возвращенного отчета. В противном случае сообщает об отсутствии анализа AI. Пользователи также могут ввести ключ отчета в формате https://www.localfalcon.com/reports/view/0b38313fa35c37f , где 0b38313fa35c37f — ключ отчета.
• getLocalFalconTrendReport: Извлекает один отчет о тенденциях Local Falcon. Отчет о тенденциях выглядит как https://www.localfalcon.com/reports/trend/view/95290829819f6e8 , где 95290829819f6e8 — ключ отчета.
• listLocalFalconKeywordReports: Извлекает список всех отчетов по ключевым словам. Отчет по ключевым словам выглядит как https://www.localfalcon.com/reports/keyword/view/754ffcb0f309938 , где 754ffcb0f309938 — ключ отчета.
• getLocalFalconKeywordReport: извлекает один отчет по ключевым словам Local Falcon.
• getLocalFalconGrid: вспомогательный метод для создания локальной сетки Falcon.
• getLocalFalconGoogleBusinessLocations: извлекает локальные местоположения Falcon Google Business.
• getLocalFalconRankingAtCoordinate: извлекает результаты поиска в указанной точке координат и получает данные рейтинга для указанной компании.
• getLocalFalconKeywordAtCoordinate: извлекает результаты поиска в указанной точке координат без каких-либо данных сравнения рангов.
• runLocalFalconFullGridSearch: выполняет полный поиск по сетке, используя переданное ключевое слово или поисковый термин для сопоставления с указанным предприятием.
• getLocalFalconCompetitorReports: получает список всех отчетов о конкурентах в вашей учетной записи Local Falcon.
• getLocalFalconCompetitorReport: извлекает до 20 компаний-конкурентов из определенного отчета о конкурентах из вашей учетной записи Local Falcon.
• listLocalFalconCampaignReports: получает список всех отчетов о местоположении в вашей учетной записи Local Falcon.
• getLocalFalconCampaignReport: получает полный отчет о кампании из вашей учетной записи Local Falcon.
• listLocalFalconGuardReports: получает список всех отчетов Falcon Guard в вашей учетной записи Local Falcon.
• getLocalFalconGuardReport: извлекает полный отчет Falcon Guard из вашей учетной записи Local Falcon по указанному place_id.

Для разработчиков

• Сборка (необходима для запуска в локальных хост-приложениях MCP):
  bun run build
• Запустите MCP Inspector:
  bun run inspector
• Запустите MCP-сервер:Выполните одно из следующих действий:
  bun run start bun run start:sse bun run start:stdio
  Примечание: если sse не указан, сервер по умолчанию будет использовать stdio.

Лицензия

Массачусетский технологический институт

Благодарности

• Локальный API Falcon
• Модель контекстного протокола (MCP)
• Булочка