GitHub Integration Setup
Learn how to connect Sigma SEO with your GitHub repository for automated blog posting
What You'll Need
- A GitHub account and repository
- GitHub Personal Access Token with repo permissions
- Anthropic Claude API key
- Active Sigma SEO subscription
Step-by-Step Setup Guide
Step 1: Create a GitHub Personal Access Token
Generate a token with the required permissions to access your repositories.
- Go to GitHub.com and sign in to your account
- Navigate to Settings → Developer settings → Personal access tokens → Tokens (classic)
- Click 'Generate new token (classic)'
- Set a descriptive name (e.g., 'Sigma SEO Blog Posting')
- Select the following scopes:
- • repo (Full control of private repositories)
- • workflow (Update GitHub Action workflows)
- Set an appropriate expiration date
- Click 'Generate token' and copy the token immediately
Warning: Important: Save your token securely - GitHub will not show it again!
Step 2: Prepare Your GitHub Repository (Optional)
Set up the required directory structure in your target repository.
- Navigate to your GitHub repository where you want to publish blogs
- Create a '/blog' directory in the root of your repository
- Add an HTML template file for your blog posts (optional but recommended)
- Create a 'blog.html' file for the blog listing page (optional)
- Ensure your repository has the correct structure for GitHub Pages (if using)
Tip: The /blog directory is where all your generated blog posts will be stored as HTML files.
Gitpage.site Users: If your repository was created using Gitpage.site, the proper structure is already set up and you can skip this step entirely.
Step 3: Get Your Anthropic Claude API Key
Required for AI-powered content formatting and enhancement.
- Visit console.anthropic.com and create an account or sign in
- Navigate to the API section
- Generate a new API key
- Copy the API key for use in Sigma SEO
- Ensure you have sufficient credits in your Anthropic account
Note: Claude API is used to format and enhance your blog content before posting to GitHub.
Step 4: Configure Sigma SEO Settings
Enter your credentials in the Sigma SEO dashboard.
- Go to your Sigma SEO Dashboard
- Enter your GitHub Personal Access Token in the 'GitHub Token' field
- For Repository ID - Follow these detailed steps:
- • Step 1: Navigate to your target GitHub repository
- • Step 2: Look at the URL in your browser address bar
- • Step 3: Find the pattern: https://github.com/[USERNAME]/[REPOSITORY-NAME]
- • Step 4: Copy only the USERNAME/REPOSITORY-NAME part (after 'github.com/')
- • Step 5: Paste this into the 'Repository ID' field
- • Examples: 'johndoe/my-blog', 'sarah-dev/awesome-website', 'company123/blog-posts'
- Enter your Anthropic Claude API Key
- Click 'Save' to store your settings
- The system will automatically validate your credentials
Tip: All credentials are validated in real-time to ensure they're working correctly.
Repository ID Help: The Repository ID format is 'username/repository-name'. Here are detailed steps: 1) Go to your GitHub repository page, 2) Look at the browser URL (e.g., https://github.com/johndoe/my-blog), 3) Copy everything after 'github.com/' (johndoe/my-blog), 4) This is your Repository ID. Common mistakes: Don't include 'https://github.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.
- Use any of the Sigma SEO blog generation tools (Stealth, Standard, etc.)
- Generate content for a test blog post
- Look for the GitHub posting button after content is generated
- Click the GitHub button to post your content
- Check your GitHub repository to verify the blog was posted
- Verify the blog listing page was updated (if you have one)
Success: Congratulations! Your GitHub integration is working correctly.
Troubleshooting
❌ Token authentication failed
✅ Verify your GitHub token has 'repo' and 'workflow' permissions and hasn't expired.
❌ Repository not found
✅ Check that your Repository ID is in the correct format: 'owner/repository' and that the repository exists.
❌ Wrong Repository ID format
✅ Go to your GitHub repository page, look at the URL (e.g., https://github.com/johndoe/my-blog), and copy 'johndoe/my-blog' as your Repository ID. Don't include 'https://github.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
✅ Check that your repository has a '/blog' directory and GitHub Pages is configured correctly.