@carbondigital/robots-generator

Robots generator that is used in our SEO application.


Keywords
seo, robots, generator, typescript, node, sem, links
License
GPL-3.0
Install
npm install @carbondigital/robots-generator@0.0.1

Documentation

Contributors Forks Stargazers Issues


Logo

SEM Links

Search Engine Marketing (SEM) Links, which is the working title, is a Search Engine Optimization (SEO) tool. The current goal is to tackle all of the technical SEO areas of concern. The end goal aims much higher.

Module Bugs · SEM Links Features

Table of Contents
  1. About The Project
  2. Usage
  3. Roadmap
  4. Contributing
  5. Acknowledgments

About The Project

We wanted a tool internally that would help us rapidly scale our SEO efforts, but ultimately, give us the ability to migrate offf our current toolchain for SEO. Like many agencies, our team spent thousands on SEO-realted software each year. Since we're not a multi-million dollar agency, it always hurts to pay those bills.

In light of that, we are building this software initially for our own team. We have already seen the power of competing with well-known tools that currently exist. One thing we aim to achieve is more honesty and more transparency. This is why we are building some modules has open-source NPM packages. So, give all developers the ability to see exactly what we're doing and contribute if they desire.

(back to top)

Built With

Below are the major frameworks/libraries that are currently used in this project, or soon to be added in a future release.

(back to top)

Usage

Setup Data Config for the Robots file:

// required file name: data.robots.json
{
  "data": []
}

Inside the data array, each object follows the interface formats:

export interface DataFile {
  data: Line[];
}
export interface Line {
  type: LineType;
  content: string;
}
export enum LineType {
  allow = 'allow',
  blank = 'blank',
  comment = 'comment',
  crawlDelay = 'crawl-delay',
  disallow = 'disallow',
  sitemap = 'sitemap',
  userAgent = 'user-agent',
  other = 'other'
}

This translates into the following examples for each LineType. Currently, the other type doesn't output any results. If you have a need to capture other directives that haven't been included, please submit a bug so that we can review and research it.

{
  "data": [
    {
      "type": "allow",
      "content": "/wp-admin/admin-ajax.php"
    },
    {
      "type": "blank",
      "content": ""
    },
    {
      "type": "comment",
      "content": "sitemaps section"
    },
    {
      "type": "crawl-delay",
      "content": "10"
    },
    {
      "type": "disallow",
      "content": "/wp-admin/"
    },
    {
      "type": "sitemap",
      "content": "https://carbondigital.us/sitemaps/post-sitemap1.xml"
    },
    {
      "type": "user-agent",
      "content": "SemrushBot"
    },
    {
      "type": "other",
      "content": ""
    }
  ]
}

Console.Log your robots.txt file:

import { robotsParser } from '@carbondigital/robots-parser';
robotsParser('console', './my-robots-file.txt');

Logged Output:

Sitemap: https://carbondigital.us/sitemaps/post-sitemap1.xml
Sitemap: https://carbondigital.us/sitemaps/page-sitemap1.xml
Sitemap: https://carbondigital.us/sitemaps/projects-sitemap1.xml
Sitemap: https://carbondigital.us/sitemaps/services-sitemap1.xml
Sitemap: https://carbondigital.us/sitemaps/locations-sitemap1.xml
Sitemap: https://carbondigital.us/sitemaps/category-sitemap1.xml

User-agent: SemrushBot
    Disallow: /
User-agent: SemrushBot-SA
    Disallow: /
User-agent: MJ12bot
    Disallow: /
User-agent: Mediapartners-Google
    Disallow:
User-agent: Googlebot-Image
    Disallow:
User-agent: *
    Disallow: /wp-admin/
    Allow: /wp-admin/admin-ajax.php

(back to top)

Roadmap

We've got a simple setup on Canny. You can submit either a Github issue, or a Canny feature request for the SEM Links tool.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again! See contributing.md for more details.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Acknowledgments

Without these people and tools, life would be too complicated.

(back to top)