path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

ai-automation

메타 디스크립션 길이 제한을 완벽하게 해결하는 문장 단위 clamp 구현기

J.Lab ·
목차

    최근 AI를 활용해 블로그 포스팅 자동화 파이프라인을 구축하면서 가장 신경 쓰였던 부분 중 하나가 바로 추천검색설명(메타 디스크립션) 영역이었습니다. 구글이나 네이버 같은 검색엔진에 노출되는 이 짧은 글은 검색 노출과 클릭률에 막대한 영향을 미치기 때문입니다.

    하지만 AI에게 글을 요약해 달라고 요청하면 글자 수를 맞추지 못하거나 문장 중간에서 뚝 끊겨서 출력되는 고질적인 문제가 있었습니다. 메타 디스크립션 길이 제한인 공백 포함 150자를 어떻게든 깔끔하게 맞추기 위해 겪었던 며칠간의 삽질과 해결 과정을 공유해 보려고 합니다.

    어절 단위로 자르면 깔끔할 줄 알았던 첫 번째 삽질

    가장 단순하게 접근했던 1차 시도는 150자 한도에서 문자열을 자른 뒤, 마지막 공백(어절 경계) 위치를 찾아 그 앞까지만 남겨두는 방식이었습니다. 뒤에 말줄임표를 붙여주면 자연스러울 것이라 생각했습니다.

    텍스트가 어절 중간에서 잘려 나가는 모습을 형상화한 깔끔한 아이소메트릭 일러스트

    하지만 결과물은 정말 어색하기 짝이 없었습니다. 예를 들어 "최근 인공지능 기술이 급격하게 발전하면서 우리의 일상도..." 처럼 문장의 중간에서 뚝 끊긴 형태가 되어 버렸습니다. 검색결과 창에서 이런 잘린 문장을 보면 신뢰도가 뚝 떨어집니다.

    결국 독자가 검색결과만 보고도 완결성 있는 정보를 얻게 하려면, 단순히 글자 수나 어절 단위로 자르는 것이 아니라 반드시 완벽한 문장 단위로 텍스트를 끊어주어야 한다는 결론에 도달했습니다.

    완결된 문장만 남기는 clampSearchDescription() 함수 설계

    이 문제를 해결하기 위해 문장 단위 clamp 기능을 구현했습니다. 텍스트를 종결부호(마침표, 느낌표, 물음표) 단위로 쪼갠 뒤, 150자 한도를 넘지 않는 선에서 문장을 차례대로 누적하여 합치는 로직입니다.

    텍스트를 분석하여 완결된 문장 단위로 깔끔하게 정리하는 과정을 나타낸 테크 일러스트

    이렇게 만든 clampSearchDescription() 함수는 150자 한도 내에 들어오는 마지막 완결된 문장까지만 깔끔하게 남겨줍니다. 하지만 여기에도 예외 케이스가 있었습니다. 만약 AI가 생성한 첫 번째 문장 자체가 너무 길어 150자를 초과해 버리면 어떻게 될까요?

    이럴 경우 함수는 누적할 수 있는 완성된 문장이 없기 때문에 빈 문자열을 반환하게 됩니다. 빈 메타 디스크립션을 그대로 둘 수는 없었기에, 확실한 이중 방어 전략이 필요했습니다.

    재생성 폴백과 프롬프트 튜닝으로 완성한 이중 방어 체계

    첫 문장부터 150자를 초과해 빈 문자열이 반환될 때는 곧바로 재생성 폴백 함수인 regenerateShortDescription()을 호출하도록 구조를 짰습니다. 이 함수는 AI에게 다시 요청을 보내 아예 처음부터 120자 내외의 완결된 한 문장으로 디스크립션을 새로 작성하도록 설계했습니다.

    오류가 발생했을 때 백업 시스템으로 자동 전환되는 재생성 폴백 과정을 묘사한 흐름 일러스트

    동시에 AI 프롬프트도 대폭 수정했습니다. 처음부터 150자를 아슬아슬하게 채우지 않도록 '130~140자 내외의 여유 있는 길이로 작성할 것'과 '반드시 마침표로 끝나는 완결된 문장 형태로 구성할 것'을 명시했습니다.

    이렇게 프로그램적인 clamp 로직과 API 재생성 폴백, 그리고 프롬프트 최적화까지 삼박자를 맞추고 나니 비로소 완벽한 결과물이 나오기 시작했습니다. 현재 운영 중인 4개의 자동화 스크립트에 이 로직을 동일하게 적용하여 아주 안정적으로 작동하고 있습니다.

    마치며: 결국 디테일이 완성도를 만든다

    단순히 글자 수를 잘라내는 것은 쉽지만, 검색 환경에서 사용자가 느낄 경험을 고려해 문장 단위로 다듬는 일은 또 다른 차원의 디테일이었습니다. 자동화 프로세스에서 예외 처리가 왜 중요한지 다시금 깨닫는 계기가 되었습니다.

    메타 디스크립션 길이 제한 때문에 고민 중이시라면 단순한 글자 수 자르기 대신 문장 단위의 마이크로 클램프 로직과 재생성 폴백 구조를 함께 고민해 보시길 강력히 추천드립니다. 작은 디테일이 블로그의 전문성을 완전히 다르게 만듭니다.

    ai-automation api-fallback clamping-text javascript meta-description seo-optimization
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger