Back to Help Center

GitLab Integration Setup

Learn how to connect Sigma SEO with your GitLab project for automated blog posting

What You'll Need

  • A GitLab account and project
  • GitLab Personal Access Token with api scope
  • Anthropic Claude API key
  • Active Sigma SEO subscription

Step-by-Step Setup Guide

Step 1: Create a GitLab Personal Access Token

Generate a token with the required permissions to access your projects.

  1. Go to GitLab.com and sign in to your account
  2. Navigate to User Settings → Access Tokens (or Preferences → Access Tokens)
  3. Click 'Add new token'
  4. Set a descriptive name (e.g., 'Sigma SEO Blog Posting')
  5. Select the following scopes:
  6. • api (Full API access)
  7. Set an appropriate expiration date
  8. Click 'Create personal access token' and copy the token immediately

Warning: Important: Save your token securely - GitLab will not show it again!

Step 2: Prepare Your GitLab Repository (Optional)

Set up the required directory structure in your target project.

  1. Navigate to your GitLab project where you want to publish blogs
  2. Create a '/blog' directory in the root of your repository
  3. Add an HTML template file for your blog posts (optional but recommended)
  4. Create a 'blog.html' file for the blog listing page (optional)
  5. Ensure GitLab Pages is enabled in your project settings (Settings → Pages)

Tip: The /blog directory is where all your generated blog posts will be stored as HTML files.

Step 3: Get Your Anthropic Claude API Key

Required for AI-powered content formatting and enhancement.

  1. Visit console.anthropic.com and create an account or sign in
  2. Navigate to the API section
  3. Generate a new API key
  4. Copy the API key for use in Sigma SEO
  5. Ensure you have sufficient credits in your Anthropic account

Note: Claude API is used to format and enhance your blog content before posting to GitLab.

Step 4: Configure Sigma SEO Settings

Enter your credentials in the Sigma SEO dashboard.

  1. Go to your Sigma SEO Dashboard
  2. Select 'GitLab' as your Git Platform
  3. Enter your GitLab Personal Access Token in the 'GitLab Access Token' field
  4. For Project ID - Follow these detailed steps:
  5. • Step 1: Navigate to your target GitLab project
  6. • Step 2: Look at the URL in your browser address bar
  7. • Step 3: Find the pattern: https://gitlab.com/[USERNAME]/[PROJECT-NAME]
  8. • Step 4: Copy only the USERNAME/PROJECT-NAME part (after 'gitlab.com/')
  9. • Step 5: Paste this into the 'GitLab Project ID' field
  10. • Examples: 'johndoe/my-blog', 'sarah-dev/awesome-website', 'company123/blog-posts'
  11. Enter your Anthropic Claude API Key
  12. Click 'Save' to store your settings
  13. The system will automatically validate your credentials

Tip: All credentials are validated in real-time to ensure they're working correctly.

Project ID Help: The Project ID format is 'username/project-name'. Here are detailed steps: 1) Go to your GitLab project page, 2) Look at the browser URL (e.g., https://gitlab.com/johndoe/my-blog), 3) Copy everything after 'gitlab.com/' (johndoe/my-blog), 4) This is your Project ID. Common mistakes: Don't include 'https://gitlab.com/', don't add extra slashes, ensure exact spelling (case-sensitive).

Step 5: Test Your Setup

Generate and post your first blog to verify everything works.

  1. Use any of the Sigma SEO blog generation tools (Stealth, Standard, etc.)
  2. Generate content for a test blog post
  3. Look for the posting button after content is generated
  4. Click the button to post your content to GitLab
  5. Check your GitLab project to verify the blog was posted
  6. Verify the blog listing page was updated (if you have one)

Success: Congratulations! Your GitLab integration is working correctly.

Troubleshooting

❌ Token authentication failed

✅ Verify your GitLab token has 'api' scope and hasn't expired.

❌ Project not found

✅ Check that your Project ID is in the correct format: 'owner/project-name' and that the project exists.

❌ Wrong Project ID format

✅ Go to your GitLab project page, look at the URL (e.g., https://gitlab.com/johndoe/my-blog), and copy 'johndoe/my-blog' as your Project ID. Don't include 'https://gitlab.com/' or any other parts.

❌ Claude API errors

✅ Ensure your Anthropic API key is valid and you have sufficient credits in your account.

❌ Posts not appearing on GitLab Pages

✅ Check that your project has a '/blog' directory, GitLab Pages is enabled, and your CI/CD pipeline is configured to deploy pages.

Helpful Resources

GitLab Token Documentation

Official GitLab guide for creating personal access tokens

Anthropic Console

Get your Claude API key from the Anthropic console

Sigma SEO Dashboard

Configure your API keys and settings

Get Support

Join our Discord community for help