Yourtext.Guru icon

Yourtext.Guru

Yourtext.Guru is an advanced SEO content optimization tool designed to help writers and marketers create high-performing content.
Join our community

Actions28

Overview

The "Check" operation of the "Guide" resource in this node allows users to analyze a given text against the semantic and SEO recommendations of a specific guide. This is useful for content creators, SEO specialists, and marketers who want to ensure their content aligns with predefined SEO guidelines and semantic structures to improve search engine performance and content quality.

Typical use cases include:

  • Validating blog posts or articles against SEO best practices defined in a guide.
  • Checking if marketing copy meets the semantic requirements of a campaign.
  • Ensuring that website content adheres to SEO recommendations before publishing.

For example, a user can input a long piece of text and specify a guide ID representing an SEO guide. The node will then return an analysis indicating how well the text matches the guide's recommendations.

Properties

Name Meaning
Guide ID The unique identifier of the guide against which the text will be checked (required).
Text The UTF-8 encoded long text content that needs to be analyzed against the guide (required).

Output

The output contains a JSON object with the analysis results of the provided text compared to the guide's SEO and semantic recommendations. This typically includes metrics, scores, or detailed feedback on how well the text conforms to the guide's criteria.

If the node supports binary data output, it would generally represent related files or reports, but for this operation, the primary output is structured JSON analysis data.

Dependencies

  • Requires an API key credential for authentication with the Yourtext.Guru service.
  • The node makes HTTP POST requests to the Yourtext.Guru API endpoint /guides/{guideId}/check.
  • Network access to https://yourtext.guru/api/v2 must be available.
  • Proper configuration of the API key credential within n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Guide ID: Ensure the Guide ID is correctly specified and exists in the Yourtext.Guru account.
    • Empty or improperly formatted text: The text must be a valid UTF-8 string and not empty.
    • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Network connectivity problems: Confirm that your environment can reach the Yourtext.Guru API endpoint.

  • Error messages:

    • 401 Unauthorized: Indicates invalid or missing API credentials. Check and update the API key.
    • 404 Not Found: The specified Guide ID does not exist. Verify the Guide ID.
    • 400 Bad Request: Usually caused by missing required parameters or invalid text format. Review input properties.
    • 500 Internal Server Error: Temporary server issue; retry after some time or contact support.

Links and References

Discussion