Big-Link-Man/JOB_FIELD_REFERENCE.md

5.8 KiB

Job Configuration Field Reference

Quick Field List

Job Level (applies to all tiers)

project_id                    - Required, integer
deployment_targets           - Array of domain strings
tier1_preferred_sites        - Array of domain strings (subset of deployment_targets)
auto_create_sites            - Boolean (NOT IMPLEMENTED - parsed but doesn't work)
create_sites_for_keywords    - Array of {keyword, count} objects (NOT IMPLEMENTED - parsed but doesn't work)
models                       - {title, outline, content} with model strings
tiered_link_count_range      - {min, max} integers
anchor_text_config           - {mode, custom_text, tier1, tier2, tier3, tier4_plus}
  - For "explicit" mode, use tier-specific arrays (tier1, tier2, etc.) instead of custom_text
failure_config               - {max_consecutive_failures, skip_on_failure}
interlinking                 - {links_per_article_min, links_per_article_max, see_also_min, see_also_max}
tiers                        - Required, object with tier1/tier2/tier3

Tier Level (per tier configuration)

count                 - Required, integer (number of articles)
min_word_count        - Integer
max_word_count        - Integer
min_h2_tags           - Integer
max_h2_tags           - Integer
min_h3_tags           - Integer
max_h3_tags           - Integer
models                - {title, outline, content} - overrides job-level
interlinking          - {links_per_article_min, links_per_article_max, see_also_min, see_also_max} - overrides job-level
anchor_text_config    - {mode, custom_text, terms} - overrides job-level for this tier only
  - For "explicit" mode, use "terms" array instead of "custom_text"

Field Behaviors

deployment_targets: Sites to deploy to (round-robin distribution)

tier1_preferred_sites: If set, tier1 only uses these sites

models: Use format "provider/model-name" (e.g., "openai/gpt-4o-mini")

anchor_text_config: Can be set at job-level (all tiers) or tier-level (specific tier)

  • "default" = Use master.config.json tier rules
  • "override" = Replace with custom_text
  • "append" = Add custom_text to tier rules
  • "explicit" = Use only explicitly provided terms (no algorithm-generated terms)
    • Job-level: Provide tier1, tier2, tier3, tier4_plus arrays with terms
    • Tier-level: Provide terms array for that specific tier
  • Tier-level config overrides job-level config for that tier

tiered_link_count_range: How many links to lower tier

  • Tier1: Always 1 link to money site (this setting ignored)
  • Tier2+: Random between min and max links to lower tier

interlinking.links_per_article_min/max: Same as tiered_link_count_range

interlinking.see_also_min/max: How many See Also links (default 4-5)

  • Randomly selects this many articles from same tier for See Also section

Defaults

If not specified, these defaults apply:

Tier1 Defaults

{
  "min_word_count": 2000,
  "max_word_count": 2500,
  "min_h2_tags": 3,
  "max_h2_tags": 5,
  "min_h3_tags": 5,
  "max_h3_tags": 10
}

Tier2 Defaults

{
  "min_word_count": 1100,
  "max_word_count": 1500,
  "min_h2_tags": 2,
  "max_h2_tags": 4,
  "min_h3_tags": 3,
  "max_h3_tags": 8
}

Tier3 Defaults

{
  "min_word_count": 850,
  "max_word_count": 1350,
  "min_h2_tags": 2,
  "max_h2_tags": 3,
  "min_h3_tags": 2,
  "max_h3_tags": 6
}

Minimal Working Example

{
  "jobs": [{
    "project_id": 1,
    "deployment_targets": ["example.com"],
    "tiers": {
      "tier1": {"count": 5},
      "tier2": {"count": 20}
    }
  }]
}

Your Current Example

{
  "jobs": [{
    "project_id": 1,
    "deployment_targets": ["getcnc.info", "www.textbullseye.com"],
    "tiers": {
      "tier1": {
        "count": 5,
        "min_word_count": 1500,
        "max_word_count": 2000,
        "models": {
          "title": "openai/gpt-4o-mini",
          "outline": "openai/gpt-4o-mini",
          "content": "anthropic/claude-3.5-sonnet"
        }
      },
      "tier2": {
        "count": 20,
        "models": {
          "title": "openai/gpt-4o-mini",
          "outline": "openai/gpt-4o-mini",
          "content": "openai/gpt-4o-mini"
        },
        "interlinking": {
          "links_per_article_min": 2,
          "links_per_article_max": 4
        }
      }
    }
  }]
}

Result Behavior

Tier 1 Articles (5):

  • 1 link to money site
  • 4 See Also links to other tier1 articles
  • Home link in nav menu

Tier 2 Articles (20):

  • 2-4 links to random tier1 articles
  • 19 See Also links to other tier2 articles
  • Home link in nav menu

Anchor Text:

  • Tier1: Uses main_keyword from project
  • Tier2: Uses related_searches from project
  • Can override with anchor_text_config

Explicit Anchor Text Example

Use "explicit" mode to specify exact anchor text terms for each tier:

{
  "jobs": [{
    "project_id": 26,
    "anchor_text_config": {
      "mode": "explicit",
      "tier1": ["high volume", "precision machining", "custom manufacturing"],
      "tier2": ["high volume production", "bulk manufacturing", "large scale"]
    },
    "tiers": {
      "tier1": {"count": 12},
      "tier2": {"count": 38}
    }
  }]
}

Or use tier-level explicit config to override job-level for a specific tier:

{
  "jobs": [{
    "project_id": 26,
    "anchor_text_config": {
      "mode": "explicit",
      "tier1": ["high volume", "precision machining"],
      "tier2": ["bulk manufacturing"]
    },
    "tiers": {
      "tier1": {
        "count": 12,
        "anchor_text_config": {
          "mode": "explicit",
          "terms": ["high volume", "precision"]
        }
      },
      "tier2": {"count": 38}
    }
  }]
}

When using "explicit" mode, the system will:

  • Use only the provided terms (no algorithm-generated terms)
  • Try to find these terms in content first, then insert if not found
  • Tier-level explicit config takes precedence over job-level for that tier