@notainc/n8n-nodes-gyazo

v0.3.3

Published

14 days ago

n8n community nodes for Gyazo integration

0High
0Medium
0Low

n8n-community-node-package n8n-nodes gyazo image upload

n8n Nodes - Gyazo integration

This is an n8n community node that integrates Gyazo with your n8n workflows, so you can run Gyazo operations, manage images, and automate image sharing tasks.

Gyazo serves an API platform for developers to capture, share, and manage screenshots and images, while n8n is a fair-code licensed tool for AI workflow automation that allows you to connect various services.

n8n Nodes - Gyazo integration

Installation (self-hosted)

For self-hosted n8n instances, you can install this community node by following these steps:

Go to Settings > Community Nodes in your n8n instance
Select Install
Enter @notainc/n8n-nodes-gyazo in the npm Package Name field
Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source
Select Install

After installation restart n8n to register the community node.

Installation on n8n cloud

For n8n cloud users:

Go to Settings > Community Nodes in your n8n cloud instance
Select Install
Enter @notainc/n8n-nodes-gyazo in the npm Package Name field
Select Install

n8n cloud will automatically restart and register the community node.

Installation for development and contributing

To install this node for development:

Clone this repository:

git clone https://github.com/nota/n8n-nodes-gyazo.git
cd n8n-nodes-gyazo

Install dependencies:
```
npm install
```
Build the node:
```
npm run build
```
Link the node locally:
```
npm link
```

Install the node into your local n8n instance:

# In your n8n custom nodes directory (usually ~/.n8n/custom/)
npm link @notainc/n8n-nodes-gyazo

Start n8n:
```
n8n start
```

Operations

The Gyazo node supports the Image resource.

Image Operations

List

Get a list of user's saved images with pagination support.

Parameters:

Page (optional): Page number for pagination (default: 1)
Per Page (optional): Number of results per page, max 100 (default: 20)

Example output:

[
	{
		"image_id": "abc123def456789012345678901234ef",
		"permalink_url": "https://gyazo.com/abc123def456789012345678901234ef",
		"thumb_url": "https://thumb.gyazo.com/thumb/200/_abc123def456789012345678901234ef.png",
		"url": "https://i.gyazo.com/abc123def456789012345678901234ef.png",
		"type": "png",
		"created_at": "2024-01-15T10:30:00+0000"
	}
]

Get

Retrieve a specific image by ID or URL.

Parameters:

Image: Resource locator supporting:
- By ID: 32-character hexadecimal string (e.g., abc123def456789012345678901234ef)
- By URL: Full Gyazo URL (e.g., https://gyazo.com/abc123def456789012345678901234ef)

Example output:

{
	"image_id": "abc123def456789012345678901234ef",
	"type": "png",
	"created_at": "2024-01-15T10:30:00+0000",
	"permalink_url": "https://gyazo.com/abc123def456789012345678901234ef",
	"thumb_url": "https://thumb.gyazo.com/thumb/200/_abc123def456789012345678901234ef.png",
	"url": "https://i.gyazo.com/abc123def456789012345678901234ef.png",
	"metadata": {
		"app": "n8n",
		"title": "Screenshot",
		"desc": "Automated screenshot"
	}
}

Search

Search for images using a query string with pagination support (Pro users only).

Parameters:

Query (required): Search query for images
Page (optional): Page number for pagination (default: 1)
Per Page (optional): Number of results per page, max 100 (default: 20)

Example usage:

Query: "workflow diagram"
Results: Images matching the search term

Upload

Upload an image to Gyazo.

Parameters:

Image Binary (required): Name of the binary property containing image data (default: data)
App Name (optional): Application name (default: n8n)
Collection ID (optional): Collection ID to add image to
Description (optional): Description for the image
Referer URL (optional): Referer site URL
Title (optional): Title for the image

Example output:

{
	"type": "png",
	"thumb_url": "https://thumb.gyazo.com/thumb/200/_def456abc123789012345678901234ef.png",
	"created_at": "2024-01-15T11:00:00+0000",
	"image_id": "def456abc123789012345678901234ef",
	"permalink_url": "https://gyazo.com/def456abc123789012345678901234ef",
	"url": "https://i.gyazo.com/def456abc123789012345678901234ef.png"
}

Update

Update an existing image's description and alt text.

Parameters:

Image: Resource locator supporting:
- By ID: 32-character hexadecimal string (e.g., abc123def456789012345678901234ef)
- By URL: Full Gyazo URL (e.g., https://gyazo.com/abc123def456789012345678901234ef)
Description (optional): Description for the image
Alt Text (optional): Alternative text for the image

Example output:

{
	"image_id": "abc123def456789012345678901234ef",
	"type": "png",
	"created_at": "2024-01-15T10:30:00+0000",
	"permalink_url": "https://gyazo.com/abc123def456789012345678901234ef",
	"thumb_url": "https://thumb.gyazo.com/thumb/200/_abc123def456789012345678901234ef.png",
	"url": "https://i.gyazo.com/abc123def456789012345678901234ef.png",
	"metadata": {
		"app": "n8n",
		"title": "Screenshot",
		"desc": "Updated description",
		"alt_text": "Updated alt text"
	}
}

Credentials

To use this node, you need to configure Gyazo API credentials:

Setting up Gyazo API Access

Create a Gyazo account at gyazo.com if you don't have one
Register an application:
- Go to Gyazo API Applications
- Click "Register new application"
- Fill in your application details
Generate an access token:
- Use the OAuth flow or generate a personal access token

Configuring credentials in n8n

In your n8n workflow, add the Gyazo node
Click on the credential dropdown and select "Create New"
Choose "Gyazo API" from the credential types
Enter your Access Token in the provided field
Click "Save" to store the credentials

The node will automatically use Bearer token authentication for all API requests.

Compatibility

This node is compatible with:

n8n version: 1.0.0 and above
Node.js version: 22.0.0 and above

Usage

Basic Image Upload Workflow

Add a trigger node (e.g., Manual Trigger, Webhook)
Add the Gyazo node:
- Set Resource to "Image"
- Set Operation to "Upload"
- Configure the binary property name (default: "data")
Configure credentials with your Gyazo API access token
Execute the workflow

Search and Process Images

Add the Gyazo node:
- Set Resource to "Image"
- Set Operation to "Search"
- Enter your search query
Process results with additional nodes (e.g., filter, transform)
Use image URLs in subsequent workflow steps

Resources

Release

This package follows semantic versioning. Current version: 0.3.3

Publishing to npm

To publish a new version:

Update the version in package.json
Run npm run build to compile the TypeScript
Run npm run lint to ensure code quality
Run npm publish to publish to npm registry

Version History

0.3.3 - Removed requestDefaults from node definition
0.3.2 - Fixed versioning issue in package.json
0.3.1 - Unified node styles into the programmatic
0.3.0 - Support updating image description and alt text, improved error handling
0.2.0 - Removed support for collection operations, added Pro user restrictions for search
0.1.0 - Initial release with image and collection operations

Troubleshooting

Authentication Issues

Problem: "Unauthorized" or "Invalid access token" errors

Solution:

Verify your access token is correct and hasn't expired
Ensure your Gyazo application has the necessary scopes

Invalid Resource Format

Problem: "Invalid Image ID format" or "Invalid Gyazo URL format" errors

Solution:

Image IDs must be 32-character hexadecimal strings
Gyazo URLs must follow the format: https://gyazo.com/{image_id}

Upload Issues

Problem: Image upload fails or returns errors

Solution:

Ensure the binary property contains valid image data
Check that the binary property name matches the configured parameter
Verify the image format is supported by Gyazo (PNG, JPEG, GIF)

Rate Limiting

Problem: "Too Many Requests" errors

Solution:

Implement delays between requests using n8n's Wait node
Reduce the number of concurrent requests
Check Gyazo API rate limits in their documentation

Node Not Appearing

Problem: Gyazo node doesn't appear in n8n after installation

Solution:

Restart your n8n instance after installing the community node
Check that the installation completed successfully
Verify the node appears in Settings > Community Nodes

For additional support, please check the GitHub repository or refer to the Gyazo API documentation.

License

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

n8n Nodes - Gyazo integration

Table of contents

Installation (self-hosted)

Installation on n8n cloud

Installation for development and contributing

Operations

Image Operations

List

Get

Search

Upload

Update

Credentials

Setting up Gyazo API Access

Configuring credentials in n8n

Compatibility

Usage

Basic Image Upload Workflow

Search and Process Images

Resources

Release

Publishing to npm

Version History

Troubleshooting

Authentication Issues

Invalid Resource Format

Upload Issues

Rate Limiting

Node Not Appearing

License