๐Ÿšจ [CRITICAL] AI_MAINTENANCE_RULES ๐Ÿšจ

์ด ๋ฌธ์„œ๋Š” ๋ธ”๋กœ๊ทธ ์ž๋™ํ™” ํŒŒ์ดํ”„๋ผ์ธ์˜ ์ƒ๋ช…์ค„์ž…๋‹ˆ๋‹ค. ํ–ฅํ›„ ์ฝ”๋“œ๋ฅผ ์ˆ˜์ •ํ•˜๋Š” ์–ด๋–ค AI๋„ ์•„๋ž˜์˜ ํ•ต์‹ฌ ์‹œ์Šคํ…œ์„ ์ž„์˜๋กœ ์ƒ๋žต, ์ตœ์ ํ™”, ๋˜๋Š” ํ›ผ์†ํ•ด์„œ๋Š” ์•ˆ ๋ฉ๋‹ˆ๋‹ค.

1. ๐Ÿ›ก๏ธ API ๋ฌด์  ์ˆœํ™˜ (Active Failover) ์‹œ์Šคํ…œ ๋ณด์กด

  • generate_with_retry ํ•จ์ˆ˜์˜ API ํ˜ธ์ถœ ์—๋Ÿฌ(ResourceExhausted ๋“ฑ) ๋ฐœ์ƒ ์‹œ ๋ฌด์กฐ๊ฑด ์ž‘๋™ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
  • 2์ค‘ ๋ฃจํ”„ ๋กœ์ง ์ ˆ๋Œ€ ๋ณด์กด: 1์ฐจ๋กœ ๋‹จ์ผ API ํ‚ค ๋‚ด์—์„œ ๋ชจ๋ธ(gemini-3.5-flash-lite -> 3.1-flash-lite)์„ ์ „ํ™˜ํ•˜๊ณ , 2์ฐจ๋กœ ๋‹ค์Œ GEMINI_API_KEY๋กœ ๊ต์ฒดํ•˜์—ฌ ์žฌ์‹œ๋„ํ•˜๋Š” ๋กœ์ง์„ ์ง€์šฐ์ง€ ๋งˆ์„ธ์š”.

2. โœ๏ธ True 3-Pass ๊ธ€์“ฐ๊ธฐ ํŒŒ์ดํ”„๋ผ์ธ (AEO/SEO ์ตœ์ ํ™”)

API ๋น„์šฉ์„ ์•„๋ผ๊ฒ ๋‹ค๊ณ  ๊ธ€์“ฐ๊ธฐ ๋‹จ๊ณ„๋ฅผ 1~2๊ฐœ๋กœ ๋‹จ์ถ•ํ•˜์ง€ ๋งˆ์„ธ์š”. ๋ฐ˜๋“œ์‹œ ์•„๋ž˜ 3๋‹จ๊ณ„๋ฅผ ๋…๋ฆฝ์ ์œผ๋กœ ํ˜ธ์ถœํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

  • Pass 1 (Write): ๊ฒ€์ƒ‰์–ด ๊ธฐ๋ฐ˜์˜ ์ •๋ณด์„ฑ ์ดˆ์•ˆ ์ƒ์„ฑ
  • Pass 2 (Check): AEO(AI ์ตœ์ ํ™”), SEO, GEO ๊ด€์ ์—์„œ ์ดˆ์•ˆ์˜ ์•ฝ์ ์„ ๋‚ ์นด๋กญ๊ฒŒ ๋น„ํŒ
  • Pass 3 (Revise): ๋น„ํŒ์„ ์ˆ˜์šฉํ•˜์—ฌ AI ํŠน์œ ์˜ ๊ธฐ๊ณ„์  ๋งํˆฌ๋ฅผ ์ œ๊ฑฐํ•œ ์‚ฌ๋žŒ๋‹ค์šด ์ „๋ฌธ๊ฐ€ ์ตœ์ข… ์›๊ณ  ์ž‘์„ฑ

3. ๐Ÿ–ผ๏ธ ์ธ๋„ค์ผ ์ด๋ฏธ์ง€ ๊ธฐํš (๋‹ค์ค‘ ์‚ฌ๋ฌผ ์กฐํ•ฉ ํ—ˆ์šฉ & ์‹ฌํ”Œ ํ”„๋กฌํ”„ํŠธ)

  • ๋Œ€์ƒ ์ œํ•œ: ์ธ๋ฌผ, ๋™๋ฌผ์€ ์ ˆ๋Œ€ ๊ธˆ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  • ์กฐํ•ฉ ํ—ˆ์šฉ: ๋ฐ˜๋“œ์‹œ 1๊ฐœ์˜ ์‚ฌ๋ฌผ์ผ ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค. ๋Œ€์ƒ์€ โ€˜์ƒ์ง•์ ์ธ ๋ฌด์ƒ๋ฌผ ์‚ฌ๋ฌผโ€™์ด๋˜, ๋ฌธ๋งฅ์— ๋งž๋Š” ์ ์ ˆํ•œ ์‚ฌ๋ฌผ๋“ค์˜ ์ž์—ฐ์Šค๋Ÿฌ์šด ์กฐํ•ฉ(์˜ˆ: ํ™ฉ๊ธˆ ๋™์ „๊ณผ ๊ณ„์‚ฐ๊ธฐ)์„ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ฌํ”Œ ํ”„๋กฌํ”„ํŠธ ๊ณ ์ •: ์ฐฐํ™ ์งˆ๊ฐ์„ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•ด ๊ณผ๋„ํ•œ ์ˆ˜์‹์–ด(Photorealistic, 8k, ultra ๋“ฑ)๋ฅผ ๋ฐฐ์ œํ•˜๊ณ  ๋ฌด์กฐ๊ฑด ์•„๋ž˜ ํฌ๋งท์„ ๊ณ ์ • ์‚ฌ์šฉํ•˜์„ธ์š”. A realistic photograph of {obj_name} on a clean desk, bright natural lighting, simple and clear

4. ๐Ÿ’ฐ ์˜๋ฌธ ๊ฒฝ์ œ ๋ธ”๋กœ๊ทธ ํ•„์ˆ˜ ๊ทœ์น™ (Golden Keyword Miner)

  • 100% ๋ฐ์ดํ„ฐ ๋“œ๋ฆฌ๋ธ ํ™ฉ๊ธˆ ํ‚ค์›Œ๋“œ ์•„ํ‚คํ…์ฒ˜ ์ ์šฉ:
    1. Google News RSS (US): ๋ฏธ๊ตญ ๊ฒฝ์ œ/๊ธˆ์œต ์‹ค์‹œ๊ฐ„ ๋‰ด์Šค ํ—ค๋“œ๋ผ์ธ์„ ์ˆ˜์ง‘ํ•˜์—ฌ ํŒฉํŠธ๋ฅผ ํ™•๋ณดํ•ฉ๋‹ˆ๋‹ค.
    2. AI Seed Extraction: ๊ฐ€์‹ญ์„ ๋ฐฐ์ œํ•˜๊ณ  ํ•ต์‹ฌ ์˜๋ฌธ ๋ช…์‚ฌ(Seed) 5๊ฐœ๋ฅผ ์ถ”์ถœํ•ฉ๋‹ˆ๋‹ค.
    3. Google Autocomplete API: ์”จ์•— ๋ช…์‚ฌ๋ฅผ ํ™•์žฅํ•˜์—ฌ ์‹ค์ œ ์œ ์ €๊ฐ€ ๊ฒ€์ƒ‰ํ•˜๋Š” ๋กฑํ…Œ์ผ ํ‚ค์›Œ๋“œ๋ฅผ ๋ฐœ๊ตดํ•ฉ๋‹ˆ๋‹ค.
    4. History Validation: posted_history.txt๋ฅผ ๋Œ€์กฐํ•˜์—ฌ ์™„๋ฒฝํžˆ ์ผ์น˜ํ•˜๋Š” ์ค‘๋ณต ํ‚ค์›Œ๋“œ๋ฅผ ์›์ฒœ ์ฐจ๋‹จํ•ฉ๋‹ˆ๋‹ค.
  • US ํƒ€๊ฒŸ ์˜๋ฌธ ์ž‘์„ฑ: ๋ชจ๋“  ์›๊ณ ๋Š” ์˜์–ด(English)๋กœ ์ž‘์„ฑ๋˜๋ฉฐ ๋ฏธ๊ตญ ์‹œ์žฅ์„ ํƒ€๊ฒŸํŒ…ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
  • ์• ๋“œ์„ผ์Šค ๋ธ”๋ก ๋ณด์กด: d_top, d_middle, d_bottom ์œ„์น˜์— ์น˜ํ™˜๋˜๋Š” ๊ณ ๋‹จ๊ฐ€ ์• ๋“œ์„ผ์Šค ๊ด‘๊ณ  ๋ธ”๋ก์„ ํ›ผ์†ํ•˜์ง€ ๋งˆ์„ธ์š”.