Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.
TypeScript aeoai-agentai-searchanswer-engine-optimizationbrand-monitoringchatgptclaudecopilotdockergeminigeogoogle-ai-overviewsgrokmcpnextjsopen-sourceperplexityseosupabasetypescript
/**
* E-E-A-T-category signal evaluators — Faz 1 ships the 3 deterministic ones
* (first-person, privacy-terms, contact-info). The LLM / external-data signals
* (case-study-evidence, author-credentials, byline-depth, brand-entity via
* Wikidata, press-mentions) land in later phases.
*
* See structure.js for the evaluator shape.
*/
import { countPhrases } from './helpers.js';
const FIRST_PERSON_PHRASES = [
'we tested',
'we built',
'we found',
'we measured',
'we analyzed',
'we analysed',
'in our experience',
'in our testing',
'our team',
'i tested',
'i built',
'i found',
'we ran',
'we compared',
'when we',
];
export const firstPerson = {
key: 'first-person',
evaluate(ctx) {
const hits = countPhrases(ctx.text, FIRST_PERSON_PHRASES);
let status = 'fail';
let score = 0;
if (hits >= 2) {
status = 'pass';
score = 1;
} else if (hits === 1) {
status = 'warn';
score = 0.5;
}
return { status, score, evidence: { evidencePhrases: hits } };
},
};
export const privacyTerms = {
key: 'privacy-terms',
evaluate(ctx) {
let privacy = false;
let terms = false;
ctx.$('a[href]').each((_, el) => {
const href = (ctx.$(el).attr('href') || '').toLowerCase();
const text = ctx.$(el).text().toLowerCase();
const blob = `${href} ${text}`;
if (/privacy/.test(blob)) privacy = true;
if (/terms|tos\b|conditions/.test(blob)) terms = true;
});
let status = 'fail';
let score = 0;
if (privacy && terms) {
status = 'pass';
score = 1;
} else if (privacy || terms) {
status = 'warn';
score = 0.5;
}
return { status, score, evidence: { privacy, terms } };
},
};
export const contactInfo = {
key: 'contact-info',
evaluate(ctx) {
const hasMailto = ctx.$('a[href^="mailto:"]').length > 0;
const hasTel = ctx.$('a[href^="tel:"]').length > 0;
let contactLink = false;
ctx.$('a[href]').each((_, el) => {
const blob = `${(ctx.$(el).attr('href') || '').toLowerCase()} ${ctx.$(el).text().toLowerCase()}`;
if (/contact|iletişim|kontakt/.test(blob)) contactLink = true;
});
const emailInText = /[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}/i.test(ctx.text);
const found = hasMailto || hasTel || contactLink || emailInText;
return {
status: found ? 'pass' : 'fail',
score: found ? 1 : 0,
evidence: { mailto: hasMailto, tel: hasTel, contactLink, emailInText },
};
},
};
export const eeatSignals = [firstPerson, privacyTerms, contactInfo];