Description


n8n-nodes-peecai

This is an n8n community node for the Peec AI API. It lets you monitor and analyze your brand visibility across AI search engines like ChatGPT, Perplexity, Gemini, and others — directly from your n8n workflows.

Peec AI is an AI Search Analytics platform that tracks how brands appear in AI-generated answers, including citations, sentiment, and competitive positioning.

n8n is a fair-code licensed workflow automation platform.

> Note: This is an unofficial community node, not affiliated with or endorsed by Peec AI.

Installation | Credentials | Operations | Usage | Compatibility | Resources | Version History

Installation

Community Nodes (Recommended)

For users on n8n v1.0+, you can install this node directly from the n8n editor:

1. Open your n8n editor
2. Go to Settings > Community Nodes
3. Search for n8n-nodes-peecai
4. Click Install

For more details, see the n8n community nodes installation guide.

Manual Installation

Navigate to your n8n installation directory and run:

npm install n8n-nodes-peecai

Then restart your n8n instance.

Credentials

You need a Peec AI API key to use this node.

1. Sign up at app.peec.ai
2. Navigate to Settings > API Keys and create a new key
3. In n8n, go to Credentials > New Credential > Peec AI API
4. Paste your API key and save

The credential is automatically validated against the Peec AI API when you save it.

Operations

1. Projects & Configuration

• Project — Get Many: List all monitoring projects in your Peec AI account

2. Monitoring Data

• Brand — Get Many: List tracked brands and their associated domains for a project
• Prompt — Get Many: List search prompts used for AI search monitoring
• Tag — Get Many: List tags for organizing prompts and reports
• Topic — Get Many: List topic categories used for analysis grouping
• Model — Get Many: List monitored AI models (ChatGPT, Perplexity, Gemini, etc.)

3. Chat Interactions

• Chat — Get Many: List tracked AI chat interactions with date filtering
• Chat — Get Content: Retrieve the full content and messages of a specific chat

4. Analytics Reports

• Brand Report — Get: Brand visibility, sentiment, competitive position, and share of voice across AI models
• Domain Report — Get: Domain-level citation frequency and visibility analytics
• URL Report — Get: URL-level citation tracking and visibility analytics

All reports support:

• Dimensions — Break down results by AI model, search prompt, tag, or topic
• Date range — Filter by start and end date using a date picker
• Filters — Server-side filtering by brand, model, tag, topic, prompt, classification, domain, or URL

5. Query Analytics

• Search Query — Get: Retrieve search queries generated by AI models for a project
• Shopping Query — Get: Retrieve shopping/product queries generated by AI models for a project

Query resources support date range filtering, server-side filters, and limit/offset pagination.

Pagination

All “Get Many” operations include a Return All toggle:

• On: Automatically paginates through all available results
• Off: Returns up to the specified Limit (default: 50) with optional Offset

Usage

Basic Workflow

1. Add a Peec AI node to your workflow
2. Select a resource (e.g. Brand Report) and operation
3. Choose your project from the dropdown
4. Configure date range, dimensions, and filters as needed
5. Execute the node to retrieve your analytics data

AI Agent Integration

This node has usableAsTool enabled, which means it can be used as a tool by n8n’s AI Agent node. This allows AI agents to query Peec AI data autonomously as part of a conversation or reasoning chain.

Example Use Cases

• Automated reporting — Schedule daily or weekly brand visibility reports and send them via email or Slack
• Alert on changes — Monitor brand sentiment and trigger alerts when it drops below a threshold
• Competitive analysis — Compare brand positioning across AI models over time
• Data pipeline — Feed Peec AI analytics into a data warehouse or dashboard tool

Compatibility

| Requirement | Version |
|————-|———|
| n8n | >= 1.85.0 |
| Node.js | >= 18.17.0 |

Requires n8n 1.85.0+ due to NodeConnectionTypes and usableAsTool support. Tested with n8n v2.9.x (self-hosted Docker).

Resources

• Peec AI Website
• Peec AI App
• n8n Community Nodes Documentation
• n8n Community Forum

Development

git clone https://github.com/thein-art/n8n-nodes-peecai.git
cd n8n-nodes-peecai
npm install
npm run build    # Build with n8n node CLI
npm run lint     # Lint with n8n node linter rules
npm test         # Run unit tests
npm run dev      # Watch mode for development

Version History

0.6.0

• Added country_code and date dimensions for report breakdowns
• Added country_code filter field for all reports and queries
• Added chat filters: filter chats by brand, model, or prompt ID

0.5.1

• Updated devDependencies: @types/node 25.5.0, @n8n/node-cli 0.23.0, n8n-workflow 2.12.0, vitest 4.1.0

0.5.0

• Extracted helper functions to eliminate code duplication (date parsing, filter parsing)
• Added TypeScript interfaces for API response types
• Added explicit HTTP timeouts (30s) to all API requests
• Added unit test suite (21 tests) with vitest
• Added engines field to package.json (Node.js >= 18.17.0)
• Updated ESLint config to exclude test files from n8n linter

0.4.0

• Added Search Query and Shopping Query resources for AI-generated query analytics
• Added Domain and URL filter fields for domain/URL reports
• 12 resources total

0.3.2

• Fixed release pipeline: merged publish into release workflow
• Updated GitHub Actions to v6 (checkout, setup-node)
• Bumped @types/node to v25

0.3.1

• CI/CD pipeline: automated releases via git tags, npm publish with OIDC trusted publishing
• Added Dependabot for dependency updates

0.3.0

• Refactored node to resource-based file structure
• Added n8n node linter compliance
• Improved error handling and parameter descriptions

0.2.0

• Synced types with Peec AI API spec
• Added server-side filters and drift detection for reports
• Added dimensions support for analytics breakdown

0.1.0

• Initial release with full Peec AI API coverage
• 10 resources: Project, Brand, Prompt, Tag, Topic, Model, Chat, Brand/Domain/URL Reports
• Dynamic project dropdown with API validation
• Automatic pagination with Return All toggle
• AI Agent compatibility (usableAsTool)

License

MIT

—

Built by Tobias Hein at artaxo.