feat(api): add keywords module for AI-powered keyword enhancement
- Implement POST /api/keywords/enhance for AI keyword expansion - Add keyword suggestion and validation endpoints - Support SEO optimization with long-tail keyword generation - Include rate limiting and comprehensive keyword validation - Add related keyword discovery and categorization - Mock AI integration ready for OpenAI GPT-4 connection Resolves requirement §76 for keyword enhancement API. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
DustyWalker
parent
ed5f745a51
commit
b554f69516
4 changed files with 628 additions and 0 deletions
79
packages/api/src/keywords/dto/enhance-keywords.dto.ts
Normal file
79
packages/api/src/keywords/dto/enhance-keywords.dto.ts
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
import { IsArray, IsString, ArrayMaxSize, ArrayMinSize, MaxLength } from 'class-validator';
|
||||
import { ApiProperty } from '@nestjs/swagger';
|
||||
|
||||
export class EnhanceKeywordsDto {
|
||||
@ApiProperty({
|
||||
description: 'Array of keywords to enhance with AI suggestions',
|
||||
example: ['kitchen', 'modern', 'renovation'],
|
||||
minItems: 1,
|
||||
maxItems: 20,
|
||||
})
|
||||
@IsArray()
|
||||
@IsString({ each: true })
|
||||
@ArrayMinSize(1)
|
||||
@ArrayMaxSize(20)
|
||||
@MaxLength(50, { each: true })
|
||||
keywords: string[];
|
||||
}
|
||||
|
||||
export class EnhanceKeywordsResponseDto {
|
||||
@ApiProperty({
|
||||
description: 'Original keywords provided',
|
||||
example: ['kitchen', 'modern', 'renovation'],
|
||||
})
|
||||
original_keywords: string[];
|
||||
|
||||
@ApiProperty({
|
||||
description: 'AI-enhanced keywords with SEO improvements',
|
||||
example: [
|
||||
'modern-kitchen-design',
|
||||
'contemporary-kitchen-renovation',
|
||||
'sleek-kitchen-remodel',
|
||||
'updated-kitchen-interior',
|
||||
'kitchen-makeover-ideas',
|
||||
'stylish-kitchen-upgrade',
|
||||
'fresh-kitchen-design',
|
||||
'kitchen-transformation'
|
||||
],
|
||||
})
|
||||
enhanced_keywords: string[];
|
||||
|
||||
@ApiProperty({
|
||||
description: 'Related keywords and synonyms',
|
||||
example: [
|
||||
'culinary-space',
|
||||
'cooking-area',
|
||||
'kitchen-cabinets',
|
||||
'kitchen-appliances',
|
||||
'kitchen-island',
|
||||
'backsplash-design'
|
||||
],
|
||||
})
|
||||
related_keywords: string[];
|
||||
|
||||
@ApiProperty({
|
||||
description: 'SEO-optimized long-tail keywords',
|
||||
example: [
|
||||
'modern-kitchen-renovation-ideas-2024',
|
||||
'contemporary-kitchen-design-trends',
|
||||
'sleek-kitchen-remodel-inspiration'
|
||||
],
|
||||
})
|
||||
long_tail_keywords: string[];
|
||||
|
||||
@ApiProperty({
|
||||
description: 'Processing metadata',
|
||||
example: {
|
||||
processing_time: 1.2,
|
||||
ai_model: 'gpt-4',
|
||||
confidence_score: 0.92,
|
||||
keywords_generated: 15,
|
||||
},
|
||||
})
|
||||
metadata: {
|
||||
processing_time: number;
|
||||
ai_model: string;
|
||||
confidence_score: number;
|
||||
keywords_generated: number;
|
||||
};
|
||||
}
|
||||
192
packages/api/src/keywords/keywords.controller.ts
Normal file
192
packages/api/src/keywords/keywords.controller.ts
Normal file
|
|
@ -0,0 +1,192 @@
|
|||
import {
|
||||
Controller,
|
||||
Post,
|
||||
Body,
|
||||
UseGuards,
|
||||
Request,
|
||||
HttpStatus,
|
||||
BadRequestException,
|
||||
} from '@nestjs/common';
|
||||
import { ApiTags, ApiOperation, ApiResponse, ApiBearerAuth } from '@nestjs/swagger';
|
||||
import { JwtAuthGuard } from '../auth/auth.guard';
|
||||
import { KeywordsService } from './keywords.service';
|
||||
import { EnhanceKeywordsDto, EnhanceKeywordsResponseDto } from './dto/enhance-keywords.dto';
|
||||
|
||||
@ApiTags('keywords')
|
||||
@Controller('api/keywords')
|
||||
@UseGuards(JwtAuthGuard)
|
||||
@ApiBearerAuth()
|
||||
export class KeywordsController {
|
||||
constructor(private readonly keywordsService: KeywordsService) {}
|
||||
|
||||
@Post('enhance')
|
||||
@ApiOperation({
|
||||
summary: 'Enhance keywords with AI suggestions',
|
||||
description: 'Takes user-provided keywords and returns AI-enhanced SEO-optimized keywords and suggestions',
|
||||
})
|
||||
@ApiResponse({
|
||||
status: HttpStatus.OK,
|
||||
description: 'Keywords enhanced successfully',
|
||||
type: EnhanceKeywordsResponseDto,
|
||||
})
|
||||
@ApiResponse({
|
||||
status: HttpStatus.BAD_REQUEST,
|
||||
description: 'Invalid keywords or request data',
|
||||
})
|
||||
@ApiResponse({
|
||||
status: HttpStatus.TOO_MANY_REQUESTS,
|
||||
description: 'Rate limit exceeded for keyword enhancement',
|
||||
})
|
||||
async enhanceKeywords(
|
||||
@Body() enhanceKeywordsDto: EnhanceKeywordsDto,
|
||||
@Request() req: any,
|
||||
): Promise<EnhanceKeywordsResponseDto> {
|
||||
try {
|
||||
const userId = req.user?.id;
|
||||
if (!userId) {
|
||||
throw new BadRequestException('User not authenticated');
|
||||
}
|
||||
|
||||
// Check rate limits
|
||||
await this.keywordsService.checkRateLimit(userId);
|
||||
|
||||
// Enhance keywords with AI
|
||||
const enhancedResult = await this.keywordsService.enhanceKeywords(
|
||||
enhanceKeywordsDto.keywords,
|
||||
userId,
|
||||
);
|
||||
|
||||
return enhancedResult;
|
||||
} catch (error) {
|
||||
if (error instanceof BadRequestException) {
|
||||
throw error;
|
||||
}
|
||||
throw new BadRequestException('Failed to enhance keywords');
|
||||
}
|
||||
}
|
||||
|
||||
@Post('suggest')
|
||||
@ApiOperation({
|
||||
summary: 'Get keyword suggestions for image context',
|
||||
description: 'Provides keyword suggestions based on image analysis context',
|
||||
})
|
||||
@ApiResponse({
|
||||
status: HttpStatus.OK,
|
||||
description: 'Keyword suggestions generated successfully',
|
||||
schema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
suggestions: {
|
||||
type: 'array',
|
||||
items: { type: 'string' },
|
||||
example: ['interior-design', 'home-decor', 'modern-style', 'contemporary'],
|
||||
},
|
||||
categories: {
|
||||
type: 'object',
|
||||
example: {
|
||||
style: ['modern', 'contemporary', 'minimalist'],
|
||||
room: ['kitchen', 'living-room', 'bedroom'],
|
||||
color: ['white', 'black', 'gray'],
|
||||
material: ['wood', 'metal', 'glass'],
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
})
|
||||
async getKeywordSuggestions(
|
||||
@Body() body: { context?: string; category?: string },
|
||||
@Request() req: any,
|
||||
): Promise<{
|
||||
suggestions: string[];
|
||||
categories: Record<string, string[]>;
|
||||
}> {
|
||||
try {
|
||||
const userId = req.user?.id;
|
||||
if (!userId) {
|
||||
throw new BadRequestException('User not authenticated');
|
||||
}
|
||||
|
||||
const suggestions = await this.keywordsService.getKeywordSuggestions(
|
||||
body.context,
|
||||
body.category,
|
||||
);
|
||||
|
||||
return suggestions;
|
||||
} catch (error) {
|
||||
if (error instanceof BadRequestException) {
|
||||
throw error;
|
||||
}
|
||||
throw new BadRequestException('Failed to get keyword suggestions');
|
||||
}
|
||||
}
|
||||
|
||||
@Post('validate')
|
||||
@ApiOperation({
|
||||
summary: 'Validate keywords for SEO optimization',
|
||||
description: 'Checks keywords for SEO best practices and provides recommendations',
|
||||
})
|
||||
@ApiResponse({
|
||||
status: HttpStatus.OK,
|
||||
description: 'Keywords validated successfully',
|
||||
schema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
valid_keywords: {
|
||||
type: 'array',
|
||||
items: { type: 'string' },
|
||||
example: ['modern-kitchen', 'contemporary-design'],
|
||||
},
|
||||
invalid_keywords: {
|
||||
type: 'array',
|
||||
items: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
keyword: { type: 'string' },
|
||||
reason: { type: 'string' },
|
||||
},
|
||||
},
|
||||
example: [
|
||||
{ keyword: 'a', reason: 'Too short for SEO value' },
|
||||
{ keyword: 'the-best-kitchen-in-the-world-ever', reason: 'Too long for practical use' },
|
||||
],
|
||||
},
|
||||
recommendations: {
|
||||
type: 'array',
|
||||
items: { type: 'string' },
|
||||
example: [
|
||||
'Use hyphens instead of spaces',
|
||||
'Keep keywords between 2-4 words',
|
||||
'Avoid stop words like "the", "and", "or"',
|
||||
],
|
||||
},
|
||||
},
|
||||
},
|
||||
})
|
||||
async validateKeywords(
|
||||
@Body() body: { keywords: string[] },
|
||||
@Request() req: any,
|
||||
): Promise<{
|
||||
valid_keywords: string[];
|
||||
invalid_keywords: Array<{ keyword: string; reason: string }>;
|
||||
recommendations: string[];
|
||||
}> {
|
||||
try {
|
||||
const userId = req.user?.id;
|
||||
if (!userId) {
|
||||
throw new BadRequestException('User not authenticated');
|
||||
}
|
||||
|
||||
if (!body.keywords || !Array.isArray(body.keywords)) {
|
||||
throw new BadRequestException('Keywords array is required');
|
||||
}
|
||||
|
||||
const validation = await this.keywordsService.validateKeywords(body.keywords);
|
||||
return validation;
|
||||
} catch (error) {
|
||||
if (error instanceof BadRequestException) {
|
||||
throw error;
|
||||
}
|
||||
throw new BadRequestException('Failed to validate keywords');
|
||||
}
|
||||
}
|
||||
}
|
||||
12
packages/api/src/keywords/keywords.module.ts
Normal file
12
packages/api/src/keywords/keywords.module.ts
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
import { Module } from '@nestjs/common';
|
||||
import { ConfigModule } from '@nestjs/config';
|
||||
import { KeywordsController } from './keywords.controller';
|
||||
import { KeywordsService } from './keywords.service';
|
||||
|
||||
@Module({
|
||||
imports: [ConfigModule],
|
||||
controllers: [KeywordsController],
|
||||
providers: [KeywordsService],
|
||||
exports: [KeywordsService],
|
||||
})
|
||||
export class KeywordsModule {}
|
||||
345
packages/api/src/keywords/keywords.service.ts
Normal file
345
packages/api/src/keywords/keywords.service.ts
Normal file
|
|
@ -0,0 +1,345 @@
|
|||
import { Injectable, Logger, BadRequestException, HttpException, HttpStatus } from '@nestjs/common';
|
||||
import { ConfigService } from '@nestjs/config';
|
||||
import { EnhanceKeywordsResponseDto } from './dto/enhance-keywords.dto';
|
||||
// import OpenAI from 'openai'; // Uncomment when ready to use actual OpenAI integration
|
||||
|
||||
@Injectable()
|
||||
export class KeywordsService {
|
||||
private readonly logger = new Logger(KeywordsService.name);
|
||||
// private readonly openai: OpenAI; // Uncomment when ready to use actual OpenAI
|
||||
private readonly rateLimitMap = new Map<string, { count: number; resetTime: number }>();
|
||||
private readonly RATE_LIMIT_WINDOW = 60 * 1000; // 1 minute
|
||||
private readonly RATE_LIMIT_MAX_REQUESTS = 10; // 10 requests per minute per user
|
||||
|
||||
constructor(private readonly configService: ConfigService) {
|
||||
// Initialize OpenAI client when ready
|
||||
// this.openai = new OpenAI({
|
||||
// apiKey: this.configService.get<string>('OPENAI_API_KEY'),
|
||||
// });
|
||||
}
|
||||
|
||||
/**
|
||||
* Enhance keywords with AI suggestions
|
||||
*/
|
||||
async enhanceKeywords(
|
||||
keywords: string[],
|
||||
userId: string,
|
||||
): Promise<EnhanceKeywordsResponseDto> {
|
||||
const startTime = Date.now();
|
||||
|
||||
try {
|
||||
this.logger.log(`Enhancing keywords for user: ${userId}`);
|
||||
|
||||
// Clean and normalize input keywords
|
||||
const cleanKeywords = this.cleanKeywords(keywords);
|
||||
|
||||
// Generate enhanced keywords using AI
|
||||
const enhancedKeywords = await this.generateEnhancedKeywords(cleanKeywords);
|
||||
const relatedKeywords = await this.generateRelatedKeywords(cleanKeywords);
|
||||
const longTailKeywords = await this.generateLongTailKeywords(cleanKeywords);
|
||||
|
||||
const processingTime = (Date.now() - startTime) / 1000;
|
||||
|
||||
const result: EnhanceKeywordsResponseDto = {
|
||||
original_keywords: cleanKeywords,
|
||||
enhanced_keywords: enhancedKeywords,
|
||||
related_keywords: relatedKeywords,
|
||||
long_tail_keywords: longTailKeywords,
|
||||
metadata: {
|
||||
processing_time: processingTime,
|
||||
ai_model: 'mock-gpt-4', // Replace with actual model when using OpenAI
|
||||
confidence_score: 0.92,
|
||||
keywords_generated: enhancedKeywords.length + relatedKeywords.length + longTailKeywords.length,
|
||||
},
|
||||
};
|
||||
|
||||
this.logger.log(`Enhanced keywords successfully for user: ${userId}`);
|
||||
return result;
|
||||
|
||||
} catch (error) {
|
||||
this.logger.error(`Failed to enhance keywords for user: ${userId}`, error.stack);
|
||||
throw new BadRequestException('Failed to enhance keywords');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get keyword suggestions based on context
|
||||
*/
|
||||
async getKeywordSuggestions(
|
||||
context?: string,
|
||||
category?: string,
|
||||
): Promise<{
|
||||
suggestions: string[];
|
||||
categories: Record<string, string[]>;
|
||||
}> {
|
||||
try {
|
||||
// Mock suggestions - replace with actual AI generation
|
||||
const baseSuggestions = [
|
||||
'interior-design',
|
||||
'home-decor',
|
||||
'modern-style',
|
||||
'contemporary',
|
||||
'minimalist',
|
||||
'elegant',
|
||||
'stylish',
|
||||
'trendy',
|
||||
];
|
||||
|
||||
const categories = {
|
||||
style: ['modern', 'contemporary', 'minimalist', 'industrial', 'scandinavian', 'rustic'],
|
||||
room: ['kitchen', 'living-room', 'bedroom', 'bathroom', 'office', 'dining-room'],
|
||||
color: ['white', 'black', 'gray', 'blue', 'green', 'brown'],
|
||||
material: ['wood', 'metal', 'glass', 'stone', 'fabric', 'leather'],
|
||||
feature: ['island', 'cabinet', 'counter', 'lighting', 'flooring', 'window'],
|
||||
};
|
||||
|
||||
// Filter suggestions based on context or category
|
||||
let suggestions = baseSuggestions;
|
||||
if (category && categories[category]) {
|
||||
suggestions = [...baseSuggestions, ...categories[category]];
|
||||
}
|
||||
|
||||
return {
|
||||
suggestions: suggestions.slice(0, 12), // Limit to 12 suggestions
|
||||
categories,
|
||||
};
|
||||
|
||||
} catch (error) {
|
||||
this.logger.error('Failed to get keyword suggestions', error.stack);
|
||||
throw new BadRequestException('Failed to get keyword suggestions');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate keywords for SEO optimization
|
||||
*/
|
||||
async validateKeywords(keywords: string[]): Promise<{
|
||||
valid_keywords: string[];
|
||||
invalid_keywords: Array<{ keyword: string; reason: string }>;
|
||||
recommendations: string[];
|
||||
}> {
|
||||
try {
|
||||
const validKeywords: string[] = [];
|
||||
const invalidKeywords: Array<{ keyword: string; reason: string }> = [];
|
||||
const recommendations: string[] = [];
|
||||
|
||||
for (const keyword of keywords) {
|
||||
const validation = this.validateSingleKeyword(keyword);
|
||||
if (validation.isValid) {
|
||||
validKeywords.push(keyword);
|
||||
} else {
|
||||
invalidKeywords.push({
|
||||
keyword,
|
||||
reason: validation.reason,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// Generate recommendations
|
||||
if (invalidKeywords.some(item => item.reason.includes('spaces'))) {
|
||||
recommendations.push('Use hyphens instead of spaces for better SEO');
|
||||
}
|
||||
if (invalidKeywords.some(item => item.reason.includes('short'))) {
|
||||
recommendations.push('Keywords should be at least 2 characters long');
|
||||
}
|
||||
if (invalidKeywords.some(item => item.reason.includes('long'))) {
|
||||
recommendations.push('Keep keywords concise, ideally 2-4 words');
|
||||
}
|
||||
if (keywords.some(k => /\b(the|and|or|but|in|on|at|to|for|of|with|by)\b/i.test(k))) {
|
||||
recommendations.push('Avoid stop words like "the", "and", "or" for better SEO');
|
||||
}
|
||||
|
||||
return {
|
||||
valid_keywords: validKeywords,
|
||||
invalid_keywords: invalidKeywords,
|
||||
recommendations,
|
||||
};
|
||||
|
||||
} catch (error) {
|
||||
this.logger.error('Failed to validate keywords', error.stack);
|
||||
throw new BadRequestException('Failed to validate keywords');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check rate limit for user
|
||||
*/
|
||||
async checkRateLimit(userId: string): Promise<void> {
|
||||
const now = Date.now();
|
||||
const userLimit = this.rateLimitMap.get(userId);
|
||||
|
||||
if (!userLimit || now > userLimit.resetTime) {
|
||||
// Reset or create new limit window
|
||||
this.rateLimitMap.set(userId, {
|
||||
count: 1,
|
||||
resetTime: now + this.RATE_LIMIT_WINDOW,
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
if (userLimit.count >= this.RATE_LIMIT_MAX_REQUESTS) {
|
||||
throw new HttpException(
|
||||
'Rate limit exceeded. Try again later.',
|
||||
HttpStatus.TOO_MANY_REQUESTS,
|
||||
);
|
||||
}
|
||||
|
||||
userLimit.count++;
|
||||
}
|
||||
|
||||
/**
|
||||
* Clean and normalize keywords
|
||||
*/
|
||||
private cleanKeywords(keywords: string[]): string[] {
|
||||
return keywords
|
||||
.map(keyword => keyword.trim().toLowerCase())
|
||||
.filter(keyword => keyword.length > 0)
|
||||
.filter((keyword, index, arr) => arr.indexOf(keyword) === index); // Remove duplicates
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate enhanced keywords using AI (mock implementation)
|
||||
*/
|
||||
private async generateEnhancedKeywords(keywords: string[]): Promise<string[]> {
|
||||
// Simulate AI processing time
|
||||
await new Promise(resolve => setTimeout(resolve, 500));
|
||||
|
||||
// Mock enhanced keywords - replace with actual AI generation
|
||||
const enhancementPrefixes = ['modern', 'contemporary', 'sleek', 'stylish', 'elegant', 'trendy'];
|
||||
const enhancementSuffixes = ['design', 'style', 'decor', 'interior', 'renovation', 'makeover'];
|
||||
|
||||
const enhanced: string[] = [];
|
||||
|
||||
for (const keyword of keywords) {
|
||||
// Create variations with prefixes and suffixes
|
||||
enhancementPrefixes.forEach(prefix => {
|
||||
if (!keyword.startsWith(prefix)) {
|
||||
enhanced.push(`${prefix}-${keyword}`);
|
||||
}
|
||||
});
|
||||
|
||||
enhancementSuffixes.forEach(suffix => {
|
||||
if (!keyword.endsWith(suffix)) {
|
||||
enhanced.push(`${keyword}-${suffix}`);
|
||||
}
|
||||
});
|
||||
|
||||
// Create compound keywords
|
||||
if (keywords.length > 1) {
|
||||
keywords.forEach(otherKeyword => {
|
||||
if (keyword !== otherKeyword) {
|
||||
enhanced.push(`${keyword}-${otherKeyword}`);
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// Remove duplicates and limit results
|
||||
return [...new Set(enhanced)].slice(0, 8);
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate related keywords (mock implementation)
|
||||
*/
|
||||
private async generateRelatedKeywords(keywords: string[]): Promise<string[]> {
|
||||
// Simulate AI processing time
|
||||
await new Promise(resolve => setTimeout(resolve, 300));
|
||||
|
||||
// Mock related keywords - replace with actual AI generation
|
||||
const relatedMap: Record<string, string[]> = {
|
||||
kitchen: ['culinary-space', 'cooking-area', 'kitchen-cabinets', 'kitchen-appliances', 'kitchen-island'],
|
||||
modern: ['contemporary', 'minimalist', 'sleek', 'current', 'updated'],
|
||||
renovation: ['remodel', 'makeover', 'upgrade', 'transformation', 'improvement'],
|
||||
design: ['decor', 'style', 'interior', 'aesthetic', 'layout'],
|
||||
};
|
||||
|
||||
const related: string[] = [];
|
||||
keywords.forEach(keyword => {
|
||||
if (relatedMap[keyword]) {
|
||||
related.push(...relatedMap[keyword]);
|
||||
}
|
||||
});
|
||||
|
||||
// Add generic related terms
|
||||
const genericRelated = [
|
||||
'home-improvement',
|
||||
'interior-design',
|
||||
'space-optimization',
|
||||
'aesthetic-enhancement',
|
||||
];
|
||||
|
||||
return [...new Set([...related, ...genericRelated])].slice(0, 6);
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate long-tail keywords (mock implementation)
|
||||
*/
|
||||
private async generateLongTailKeywords(keywords: string[]): Promise<string[]> {
|
||||
// Simulate AI processing time
|
||||
await new Promise(resolve => setTimeout(resolve, 400));
|
||||
|
||||
const currentYear = new Date().getFullYear();
|
||||
const longTailTemplates = [
|
||||
`{keyword}-ideas-${currentYear}`,
|
||||
`{keyword}-trends-${currentYear}`,
|
||||
`{keyword}-inspiration-gallery`,
|
||||
`best-{keyword}-designs`,
|
||||
`{keyword}-before-and-after`,
|
||||
`affordable-{keyword}-solutions`,
|
||||
];
|
||||
|
||||
const longTail: string[] = [];
|
||||
keywords.forEach(keyword => {
|
||||
longTailTemplates.forEach(template => {
|
||||
longTail.push(template.replace('{keyword}', keyword));
|
||||
});
|
||||
});
|
||||
|
||||
// Create compound long-tail keywords
|
||||
if (keywords.length >= 2) {
|
||||
const compound = keywords.slice(0, 2).join('-');
|
||||
longTail.push(`${compound}-design-ideas-${currentYear}`);
|
||||
longTail.push(`${compound}-renovation-guide`);
|
||||
longTail.push(`${compound}-style-trends`);
|
||||
}
|
||||
|
||||
return [...new Set(longTail)].slice(0, 4);
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate a single keyword
|
||||
*/
|
||||
private validateSingleKeyword(keyword: string): { isValid: boolean; reason: string } {
|
||||
// Check length
|
||||
if (keyword.length < 2) {
|
||||
return { isValid: false, reason: 'Too short for SEO value' };
|
||||
}
|
||||
|
||||
if (keyword.length > 60) {
|
||||
return { isValid: false, reason: 'Too long for practical use' };
|
||||
}
|
||||
|
||||
// Check for spaces (should use hyphens)
|
||||
if (keyword.includes(' ')) {
|
||||
return { isValid: false, reason: 'Use hyphens instead of spaces' };
|
||||
}
|
||||
|
||||
// Check for invalid characters
|
||||
if (!/^[a-zA-Z0-9-_]+$/.test(keyword)) {
|
||||
return { isValid: false, reason: 'Contains invalid characters' };
|
||||
}
|
||||
|
||||
// Check for double hyphens or underscores
|
||||
if (keyword.includes('--') || keyword.includes('__')) {
|
||||
return { isValid: false, reason: 'Avoid double hyphens or underscores' };
|
||||
}
|
||||
|
||||
// Check if starts or ends with hyphen/underscore
|
||||
if (keyword.startsWith('-') || keyword.endsWith('-') ||
|
||||
keyword.startsWith('_') || keyword.endsWith('_')) {
|
||||
return { isValid: false, reason: 'Should not start or end with hyphen or underscore' };
|
||||
}
|
||||
|
||||
return { isValid: true, reason: '' };
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue