Merge pull request #119 from rasulkireev/gtpr

Use gtpr for blog posts.

Author: rasulkireev

.env.example

@@ -29,6 +29,12 @@ REDIS_PASSWORD=tuxseo
 
 ### Required ####
 
+# https://platform.openai.com/api-keys
+OPENAI_API_KEY=
+
+# https://tavily.com/
+TAVILY_API_KEY=
+
 # https://jina.ai/reader/
 JINA_READER_API_KEY=
 

CHANGELOG.md

@@ -14,6 +14,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [0.0.8] - 2025-11-23
+### Added
+- Added link exchange program for paid users
+
+### Changed
+- using gtpr for writing posts
+
+### Fixed
+- correct link on project scan
+
 ## [0.0.8] - 2025-11-12
 ### Changed
 - Navbar spacing rules

README.md

@@ -39,6 +39,8 @@
 [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/rasulkireev/tuxseo)
 
 The only required env vars are:
+- OPENAI_API_KEY
+- TAVILY_API_KEY
 - GEMINI_API_KEY
 - PERPLEXITY_API_KEY
 - JINA_READER_API_KEY

core/agents/__init__.py

@@ -3,7 +3,6 @@
 from core.agents.competitor_vs_blog_post_agent import (
     create_competitor_vs_blog_post_agent,
 )
-from core.agents.content_editor_agent import create_content_editor_agent
 from core.agents.extract_competitors_data_agent import (
     create_extract_competitors_data_agent,
 )
@@ -12,26 +11,23 @@
 from core.agents.generate_blog_post_content_agent import (
     create_generate_blog_post_content_agent,
 )
+from core.agents.insert_links_agent import create_insert_links_agent
 from core.agents.populate_competitor_details_agent import (
     create_populate_competitor_details_agent,
 )
 from core.agents.summarize_page_agent import create_summarize_page_agent
 from core.agents.title_suggestions_agent import create_title_suggestions_agent
-from core.agents.validate_blog_post_ending_agent import (
-    create_validate_blog_post_ending_agent,
-)
 
 __all__ = [
     "create_analyze_competitor_agent",
     "create_analyze_project_agent",
     "create_competitor_vs_blog_post_agent",
-    "create_content_editor_agent",
     "create_extract_competitors_data_agent",
     "create_extract_links_agent",
     "create_find_competitors_agent",
     "create_generate_blog_post_content_agent",
+    "create_insert_links_agent",
     "create_populate_competitor_details_agent",
     "create_summarize_page_agent",
     "create_title_suggestions_agent",
-    "create_validate_blog_post_ending_agent",
 ]

core/agents/content_editor_agent.py

@@ -0,0 +1,102 @@
+from pydantic_ai import Agent
+
+from core.agents.schemas import LinkInsertionContext
+from core.choices import get_default_ai_model
+
+
+def create_insert_links_agent(model=None):
+    """
+    Create an agent to insert links into blog post content organically.
+
+    Args:
+        model: Optional AI model to use. Defaults to GPT-4o.
+
+    Returns:
+        Configured Agent instance
+    """
+    if model is None:
+        model = get_default_ai_model()
+
+    agent = Agent(
+        model,
+        output_type=str,
+        deps_type=LinkInsertionContext,
+        system_prompt="""
+        You are an expert content editor specializing in organic link insertion.
+
+        Your task is to insert links from the provided project pages into the blog post content.
+        The links should be inserted naturally and organically where they add value to the reader.
+
+        CRITICAL RULES:
+        1. DO NOT edit, rewrite, or change ANY of the existing blog post content
+        2. DO NOT add new paragraphs or sentences
+        3. DO NOT remove any existing content
+        4. ONLY insert markdown links into existing text where appropriate
+        5. Insert links by wrapping relevant existing text with markdown link syntax: [text](url)
+        6. Each project page should be linked AT MOST ONCE in the entire post
+        7. Only insert links where they are contextually relevant and add value
+        8. Return the EXACT same blog post with only the links inserted
+        9. Return ONLY the markdown content, no JSON or structured output
+
+        HANDLING EXISTING REFERENCE LINKS:
+        - If the blog post contains reference-style links like "text [Source, Year](link)" or "text [1](link)"
+        - Convert them to inline links by integrating them naturally into the text
+        - Example: "This is a fact [Source, 2024](https://example.com)" → "This is [a fact](https://example.com)"
+        - Example: "According to research [1](https://example.com)" → "According to [research](https://example.com)"
+        - DO NOT keep the reference format like [Source, Year] or [1], [2], etc.
+        - Make the links flow naturally within the sentence
+
+        Link Insertion Guidelines:
+        - Look for phrases or sentences where linking would naturally enhance the content
+        - Link relevant keywords or phrases that relate to the project page content
+        - Ensure the anchor text is descriptive and natural
+        - Distribute links throughout the post (not all in one section)
+        - Prefer linking in body paragraphs over headers or introduction
+
+        Example of what TO DO:
+        Original: "This feature helps you track your website performance."
+        With Link: "This feature helps you [track your website performance](https://example.com/analytics)."
+
+        Converting Reference Links:
+        Original: "Machine learning improves accuracy [Study, 2024](https://example.com)."
+        Converted: "Machine learning [improves accuracy](https://example.com)."
+
+        Example of what NOT TO DO:
+        - DO NOT add: "Learn more about our features [here](url)" if that sentence wasn't there
+        - DO NOT change: "This is great" to "This is amazing" even with a link
+        - DO NOT restructure or reformat the content
+        - DO NOT keep reference-style citations like [Source, Year](url) or [1](url)
+        """,  # noqa: E501
+        retries=2,
+        model_settings={"max_tokens": 65500, "temperature": 0.1},
+    )
+
+    @agent.system_prompt
+    def add_link_insertion_context(ctx) -> str:
+        context: LinkInsertionContext = ctx.deps
+
+        pages_info = ""
+        for index, page in enumerate(context.project_pages, start=1):
+            pages_info += f"""
+            Page {index}:
+            - URL: {page.url}
+            - Title: {page.title}
+            - Description: {page.description}
+            - Summary: {page.summary}
+            """
+
+        return f"""
+            PROJECT PAGES TO LINK:
+            {pages_info}
+
+            BLOG POST CONTENT TO INSERT LINKS INTO:
+            {context.blog_post_content}
+
+            INSTRUCTIONS:
+            1. Insert links from the project pages above organically into the blog post
+            2. Convert any existing reference-style links (like "text [Source, Year](url)" or "text [1](url)") to natural inline links (like "[text](url)")
+            3. Do not change the content, only insert/convert links
+            4. Return only the markdown content with links properly inserted
+        """  # noqa: E501
+
+    return agent

core/agents/insert_links_agent.py

@@ -275,3 +275,12 @@ class CompetitorVsPostContext(BaseModel):
     project_pages: list[ProjectPageContext] = Field(
         default_factory=list, description="List of project pages available for linking"
     )
+
+
+class LinkInsertionContext(BaseModel):
+    """Context for inserting links into blog post content."""
+
+    blog_post_content: str = Field(description="The blog post content in markdown format")
+    project_pages: list[ProjectPageContext] = Field(
+        default_factory=list, description="List of project pages available for linking"
+    )

core/agents/schemas.py

@@ -231,6 +231,12 @@ class ToggleOGImageGenerationOut(Schema):
     message: str = ""
 
 
+class ToggleLinkExchangeOut(Schema):
+    status: str
+    enabled: bool
+    message: str = ""
+
+
 class FixGeneratedBlogPostIn(Schema):
     id: int
 

core/agents/validate_blog_post_ending_agent.py

@@ -37,6 +37,7 @@
     SubmitFeedbackIn,
     SubmitSitemapIn,
     ToggleAutoSubmissionOut,
+    ToggleLinkExchangeOut,
     ToggleOGImageGenerationOut,
     ToggleProjectKeywordUseIn,
     ToggleProjectKeywordUseOut,
@@ -452,6 +453,13 @@ def toggle_auto_submission(request: HttpRequest, project_id: int):
     profile = request.auth
     project = get_object_or_404(Project, id=project_id, profile=profile)
 
+    if not profile.is_on_pro_plan:
+        return {
+            "status": "error",
+            "enabled": False,
+            "message": "Automatic Post Submission is only available on the Pro plan. Please upgrade to access this feature.",  # noqa: E501
+        }
+
     project.enable_automatic_post_submission = not project.enable_automatic_post_submission
     project.save(update_fields=["enable_automatic_post_submission"])
 
@@ -467,12 +475,41 @@ def toggle_og_image_generation(request: HttpRequest, project_id: int):
     profile = request.auth
     project = get_object_or_404(Project, id=project_id, profile=profile)
 
+    if not profile.is_on_pro_plan:
+        return {
+            "status": "error",
+            "enabled": False,
+            "message": "OG Image Generation is only available on the Pro plan. Please upgrade to access this feature.",  # noqa: E501
+        }
+
     project.enable_automatic_og_image_generation = not project.enable_automatic_og_image_generation
     project.save(update_fields=["enable_automatic_og_image_generation"])
 
     return {"status": "success", "enabled": project.enable_automatic_og_image_generation}
 
 
+@api.post(
+    "/projects/{project_id}/toggle-link-exchange",
+    response=ToggleLinkExchangeOut,
+    auth=[session_auth],
+)
+def toggle_link_exchange(request: HttpRequest, project_id: int):
+    profile = request.auth
+    project = get_object_or_404(Project, id=project_id, profile=profile)
+
+    if not profile.is_on_pro_plan:
+        return {
+            "status": "error",
+            "enabled": False,
+            "message": "Link Exchange is only available on the Pro plan. Please upgrade to access this feature.",  # noqa: E501
+        }
+
+    project.particiate_in_link_exchange = not project.particiate_in_link_exchange
+    project.save(update_fields=["particiate_in_link_exchange"])
+
+    return {"status": "success", "enabled": project.particiate_in_link_exchange}
+
+
 @api.post("/projects/update-sitemap-url", response=UpdateSitemapUrlOut, auth=[session_auth])
 def update_sitemap_url(request: HttpRequest, data: UpdateSitemapUrlIn):
     """
@@ -1090,13 +1127,6 @@ def fix_generated_blog_post(request: HttpRequest, data: FixGeneratedBlogPostIn):
         if generated_post.project and generated_post.project.profile != profile:
             return {"status": "error", "message": "Forbidden: You do not have access to this post."}
 
-        # Check if there are actually issues to fix
-        if generated_post.blog_post_content_is_valid:
-            return {"status": "success", "message": "Blog post content is already valid."}
-
-        # Run the fix method
-        generated_post.fix_generated_blog_post()
-
         return {"status": "success", "message": "Blog post issues have been fixed successfully."}
 
     except GeneratedBlogPost.DoesNotExist: