6i>dZddlmZddlmZmZmZddlmZddl m Z m Z m Z m Z mZddlmZmZddlmZde d e fd Zde d e fd Zde d e fd Zd ed eefdZde d e fdZde d e fdZde d e fdZddedzfdZy)zl Zero-Click SERP Optimization Graph Focused workflow for capturing featured snippets, PAA, and AI Overviews )Literal) StateGraphSTARTEND)BaseCheckpointSaver)SEOCampaignState CampaignPhaseSERPFeatureTypecreate_initial_statetransition_phase)research_phasedetect_serp_features)serp_optimization_phasestatereturnc  Ktd|d t|d{}|jdi|d<g}|jd}|r/|jdgDcgc]}|jdd}}|sC|jd g}|Dcgc]&}|jd s|jd d(}}|sgd }gggggd }|D]}|j t fd dDr|dj |z#keyword_research..Rsca8&&q)c)zwhat iszwhat aredefinez meaning ofrc3@K|]}j|ywr!r"r$s r(r)z#keyword_research..TsbX((+br*)zhow tozhow dozsteps tozguide torc3&K|]}|v ywr!r$s r(r)z#keyword_research..VsdqQ(]ds)z vs z compared tozdifference betweenversusrc3@K|]}j|ywr!r"r$s r(r)z#keyword_research..Xs^X((+^r*)best ztop zlist ofztypes ofrrkeyword_categorieszero_click_keywordsz5[ZeroClickResearch] Categorized keywords: Definition=z , How-to=z , Comparison=z, List=z3[ZeroClickResearch] Error during keyword research: )printr getloweranyappendlen Exception) rkeywordsrq serp_featuresf categorizedkwer's @r(keyword_researchrBs CE)DTCU VWQ4$U++ 99X  & E(O99Z( 4F F< F9F4.F<4F99F<c Ktd |jdi|d<|jdijdg}g}|ddD];}|j|tjj t |dddd =||dd <td t|d |S#t$r!}td |g|dd <Yd}~|Sd}~wwxYww)z Expand content for People Also Ask features For each target keyword: - Find 3-5 related PAA questions - Create FAQ schema with 2-3 sentence answers - Add internal links between related questions z([PAAExpansion] Expanding content for PAArNr3z"2-3 sentences, direct answer firstFAQPagerF)rrGrelated_questions answer_format schema_typerJ paa_targetsz[PAAExpansion] Queued z PAA expansionsz[PAAExpansion] Error: ) r4r5r8r PEOPLE_ALSO_ASKrQgenerate_related_questionsr9r:)rr3r[r@rAs r( paa_expansionr^s 46, 99X  & E(O#ii"599:OQST %cr* B    / ? ? E E%?%C!E(#    *5h & &s;'7&8HI L , &qc*+)+h & L ,s/ CBB.,C. C7C CCCrcfg}|j}|jddjddjdd}|jd|d|jd|d|jd |d |jd |d|jd |d|d dS)z,Generate related PAA questions for a keywordzhow to rzwhat is r1zWhat is ?z How does z work?zWhy is z important?zWhat are the benefits of zHow do you use NrL)r6replacer8)r questionsr' base_topics r(r]r]sI}}H!!)R088RHPPQXZ\]J x |1-. y F34 wzl+67 0 A>? zl!45 Ra=c Ktd |jdi|d<|jdijdg}g}|ddD]6}|j|tjj dddd d d d d 8||dd<tdt |d|S#t$r!}td|g|dd<Yd}~|Sd}~wwxYww)z Optimize for AI Overview citations AI Overviews prefer: - Direct answers (40-60 words) - Unique data or proprietary insights - Clear authority signals - Brand mention co-occurrence z,[AIOverviewTargeting] Targeting AI OverviewsrNr3z!40-60 words, definitive statementz*Include proprietary EventheOdds data pointzCite sample size or methodologyz"Natural brand reference in context) direct_answer unique_dataauthority_signal brand_mentionz2Direct Statement -> Data/Evidence -> Context/BrandrF)rrGoptimization_strategyrIrJai_overview_targetsz[AIOverviewTargeting] Queued z AI Overview targetsz[AIOverviewTargeting] Error: )r4r5r8r AI_OVERVIEWrQr9r:)rr3rlr@rAs r(ai_overview_targetingrns 8:4 99X  & E(O#ii"599:OQST %cr* B  & & / ; ; A A%H#O(I%I * O# (  2Eh-. -c2E.F-GG[\] L 4 -aS1213h-. L 4s/ CBB)'C) C2CCCCc Ktd |jdi|d<g}|jdijdgD]+}|j|dd|jdgdd -|jdijd gD]/}|jd d k(s|j|dd dd1|jdijdgD]}|j|ddddd||dd<tdt|d|S#t$r!}td|g|dd<Yd}~|Sd}~wwxYww)z Generate and queue schema markup for SERP features Schema types: - FAQPage for PAA targeting - HowTo for how-to snippets - Article with speakable for AI assistants z'[SchemaMarkup] Generating schema markuprNr[rrWrXrF)rrZrbrJrOrHrKHowTo)rrZrJrlArticleT)rrZ speakablerJ schema_queuez[SchemaMarkup] Queued z schema implementationsz[SchemaMarkup] Error: )r4r5r8r9r:)rrstargetoptrAs r(apply_schema_markuprv$s 35'- 99X  & E(O ii"-11-D F   !),(#ZZ(;R@# !  99Xr*../FK Cww*+/??##"9~#*'% ii"-112GL F   !),(!# !  +7h' &s<'8&99PQR L - &qc*+*,h' L -s6 EB!D-1A:D-+E- E6E EEEc Ktd |jdi|d<|jdi}dt|jdijdgt|jdijdgt|jdijdgt|jdijd gt|jd gd t|jd gt|jd gt|jdgt|jdgdgdd}||dd<t |t j}tdjjj|d<td|S#t$r+}td|dt |i|dd<Yd}~d}~wwxYww)z1 Generate zero-click optimization report z#[ZeroClickReport] Generating reportrNzero_click_authorityr2rrrrr3)definition_keywordshow_to_keywordscomparison_keywords list_keywordstotal_zero_click_keywordsrOr[rlrs)rOpaa_expansionsrlschema_implementations)z;Focus on definition keywords with 40-60 word direct answersz/Create numbered step guides for how-to keywordsz&Add comparison tables for vs. keywordsz,Implement FAQPage schema for all PAA targetsz9H>HHN checkpointerc\tt}|jdt|jdt|jdt |jdt |jdt|jdt|jtd|jdd|jdd|jdd|jdd|jdd|jdt|j|}|S)a Create the zero-click SERP optimization graph Flow: 1. Keyword Research - Categorize by zero-click intent 2. Snippet Optimization - Target featured snippets 3. PAA Expansion - Expand for People Also Ask 4. AI Overview Targeting - Optimize for AI citations 5. Schema Markup - Generate structured data 6. Report - Generate optimization report This is a non-interrupt graph focused purely on SERP feature optimization. rBrTr^rn schema_markupr)r) rradd_noderBrTr^rnrvradd_edgerrcompile)rgraphcompileds r(create_zero_click_graphrs ' (E NN%'78 NN)+?@ NN?M2 NN*,AB NN?$78 NN878 NN5,- NN%'=> NN)?; NN?$;< NN*O< NN?H- NN8S!}},}7H Ordr!)__doc__typingrlanggraph.graphrrrlanggraph.checkpoint.baserstate.campaign_staterr r r r nodes.research_noder rnodes.serp_features_noderrBrTr^rrr]rnrvrrr.rdr(rs 229E<_"2_7G_DE&6E;KEP%/%4D%PS ")'7)