Skip to content

Releases: a-know/Pixela

v1.36.1

Choose a tag to compare

@a-know a-know released this 24 Sep 13:57
5e3582d

[English]

The GET - /v1/users/<username>/graphs/<graphID> API now supports a new asText=true query parameter.

When this parameter is specified, the SVG data is returned with Content-Type: text/plain instead of the default image/svg+xml. The response body itself remains unchanged.

This option is useful for text-oriented clients, including AI-powered tools and web fetchers, that do not support responses with the image/svg+xml Content-Type.

If the parameter is omitted or a value other than true is specified, the response will continue to use image/svg+xml.

For more details, please see the Pixela API documentation.

[Japanese]

GET - /v1/users/<username>/graphs/<graphID> API にて、新たに asText=true クエリパラメータをサポートしました。

このパラメータを指定すると、SVGデータをデフォルトの image/svg+xml ではなく、Content-Type: text/plain で取得できます。レスポンスボディの内容そのものは変更されません。

このオプションは、image/svg+xml のレスポンスに対応していないAIツールやWeb取得ツールなど、テキストとしてレスポンスを扱うクライアントでの利用を想定したものです。

このパラメータを省略した場合、または true 以外の値を指定した場合は、従来どおり image/svg+xml でレスポンスします。

詳細は Pixela APIドキュメント を参照してください。

v1.36.0

Choose a tag to compare

@a-know a-know released this 28 Aug 23:42
5e3582d

[English]

Pixela now supports remote MCP (Model Context Protocol) server integration.

By configuring Pixela's MCP endpoint in an MCP-compatible client such as Codex, you can use Pixela through MCP tools from that client.

Endpoint and Documentation:

For example, in Codex, you can configure Pixela MCP as follows:

[mcp_servers.pixela]
url = "https://pixe.la/mcp"
bearer_token_env_var = "PIXELA_TOKEN"

Then set your Pixela user token in the PIXELA_TOKEN environment variable before starting Codex.

Once configured, you can ask your MCP client to perform Pixela operations, such as listing graphs, creating graphs, posting Pixels, or updating today's Pixel.

Please note the following points:

  • Pixela MCP uses your existing Pixela user token for authentication.
  • When using Codex, the token is sent as an Authorization: Bearer ... header.
  • When asking an MCP client to use Pixela MCP, include your Pixela username in the request if the client does not already know it.
  • The token is used to authenticate the specified username. If the username and token do not match, the request fails in the same way as the existing Pixela API.

For more details, please refer to the Pixela API documentation.


[Japanese]

Pixela を remote MCP(Model Context Protocol)サーバー連携に対応させました。

Codex などの MCP に対応したクライアントに Pixela の MCP エンドポイントを設定することで、そのクライアントから MCP tool として Pixela を利用できます。

エンドポイントとドキュメント:

たとえば Codex では、以下のように Pixela MCP を設定できます。

[mcp_servers.pixela]
url = "https://pixe.la/mcp"
bearer_token_env_var = "PIXELA_TOKEN"

Codex を起動する前に、PIXELA_TOKEN 環境変数に Pixela user token を設定してください。

設定後は、MCP クライアントに対して Graph の一覧取得、Graph の作成、Pixel の投稿、今日の Pixel の更新などを依頼できるようになります。

ご利用の際には以下の点にご注意ください。

  • Pixela MCP は、既存の Pixela user token を認証に利用します。
  • Codex などのクライアントから利用する場合、token は Authorization: Bearer ... ヘッダーとして送信されます。
  • MCP クライアントがあなたの Pixela username を把握していない場合は、Pixela MCP を利用する依頼の中で username も指定してください。
  • token は、指定された username に対する認証に利用されます。username と token が一致しない場合は、既存の Pixela API と同様にリクエストは失敗します。

詳しくは Pixela API ドキュメントをご確認ください。

v1.35.0

Choose a tag to compare

@a-know a-know released this 27 Apr 01:45
5e3582d

[English]

image

We have added a new API endpoint, GET /v1/users/<username>/graphs/<graphID>/analyze, which allows you to have your graphs analyzed by AI and retrieve the results.

The overview and precautions are as follows.

  • The AI analyzes the Pixel posted to the graph specified by and responds with the results in a string of up to approximately 1000 characters.
  • Please pay attention to the following points.
    • The analysis will cover Pixel posts from the last year.
    • You cannot use this API if any of the following apply.
      • If allowAIProcessing is not set to true for the user.
      • In the case where a valid thanks-code is not set for the user (If you are not a Pixela Supporter).
      • If the number of Pixel posts within the last year is less than 30.
    • The AI analysis results are reset once a day.
    • The language of the analysis results is determined based on the timezone setting configured in Graph.
    • You can obtain better analysis results by setting the description for the Graph .

Please also refer to the API documentation when using this service.

[Japanese]

image

あなたのグラフをAIに分析させ、その結果を取得できるAPIエンドポイント、GET /v1/users/<username>/graphs/<graphID>/analyze を新たに追加しました。

概要および注意事項は以下のとおりです。

  • <graphID> で指定したグラフに投稿済みの Pixel を AI に分析させ、その結果を最大1000文字程度の文字列でレスポンスします。
  • 以下のような点に注意してください。
    • 直近1年間に投稿された Pixel を分析対象とします。
    • 以下のいずれかに当てはまる場合、このAPIを利用することはできません。
      • User の allowAIProcessing に true が設定されていない場合。
      • User に有効な thanks-code が設定されていない場合(あなたが Pixela Supporter でない場合)。
      • 直近1年間に投稿された Pixel の数が 30 に満たない場合。
    • AIによる分析結果は1日に1度リセットされます。
    • Graph に設定された timezone 設定を元に、分析結果の言語が決まります。
    • Graph の description を設定することで、よりよい分析結果を得ることができます。

ご利用にあたっては、APIドキュメントもご確認ください。

また、開発者の個人ブログでもこのリリースについて紹介しています。よろしければご覧ください。Pixela グラフに投稿済みの数値データをAIに分析させることができるようになりました!

v1.34.0

Choose a tag to compare

@a-know a-know released this 28 Feb 05:32
5e3582d

[English]
We have enabled the specification of a new property, description, for Graphs. For more details, please refer to the relevant API documentation below.

The configured description can be viewed by hovering over it on the screen displayed in the GET /v1/users/<username>/graphs/<graphID>.html - View a graph detail , as shown below.

image

[Japanese]
Graph に対して新たなプロパティ description を指定できるようにしました。
詳細については、関連する以下のAPIドキュメントを参照してください。

設定された description は、GET /v1/users/<username>/graphs/<graphID>.html - View a graph detail で表示される画面でマウスオーバーすることで、以下のように確認することができます。

image

v1.33.0

Choose a tag to compare

@a-know a-know released this 30 Jan 04:26
5e3582d

[English]
We have added the following two new API endpoints:

For details on each API, please refer to the linked API documentation.

These APIs will reject 25% of requests from users who are not Pixela Supporters (users with a valid thanks-code configured). For more details about Pixela Supporter, please refer to this Wiki Page.

[Japanese]
以下の2つのAPIエンドポイントを新しく追加しました。

各APIの詳細については、リンク先のAPIドキュメントをご確認ください。

これらのAPIは Pixela Supporter(有効な thanks-code が設定されているユーザー)以外のユーザーがリクエストした場合、25%の割合でリクエストがリジェクトされます。Pixela Supporter についての詳細はこちらの Wiki を参照してください。

v1.32.2

Choose a tag to compare

@a-know a-know released this 29 Oct 12:23
5e3582d

[English]
Improved the behavior when both the transparent and dark options are used in combination.

[Japanese]
transparent dark の両オプションを併用していた場合の挙動を改善しました。

v1.32.1

Choose a tag to compare

@a-know a-know released this 28 Apr 01:03
5e3582d

[English]
The following two APIs now support the transparent=true query parameter.
This allows you to make the background of a graph transparent.


[Japanese]
以下の2つのAPIにて、 transparent=true クエリパラメータを新たにサポートしました。
これを指定すると、グラフの背景を透明にできます。

v1.32.0

Choose a tag to compare

@a-know a-know released this 25 Feb 13:34
5e3582d

[English]
Added new API endpoint /v1/users/<username>/graphs/<graphID>/today.
Using this API, you can retrieve the Pixel corresponding to the requested date. You can also control whether or not a 404 error will occur if the corresponding Pixel is unregistered.
See the API documentation for details.

[Japanese]
新しいAPIエンドポイント /v1/users/<username>/graphs/<graphID>/today を追加しました。
リクエストした日に対応する Pixel を取得できます。また、該当のPixelが未登録の場合に 404 エラーとするかどうかをコントロールすることも可能です。
詳細は API ドキュメントを参照してください。

v1.31.0

Choose a tag to compare

@a-know a-know released this 20 Dec 14:00
5e3582d

[English]
Added a new property startOnMonday that can be specified for Graph.
The default value for this property is false; specify true if you want the graph to start on Monday.
See the API documentation for details.

[Japanese]
Graph に指定可能な新しいプロパティ startOnMonday を追加しました。
このプロパティの既定値は false で、そのグラフを月曜始まりにしたい場合には true を指定します。
詳細は API ドキュメントを参照してください。

v1.30.0

Choose a tag to compare

@a-know a-know released this 18 Sep 12:55
5e3582d
Screenshot 2024-08-22 at 21 06 29

[English]
GET - /v1/users/<username>/graphs/<graphID> API has supported 2 new options.

  • lessThan , greaterThan
  • This option is used to draw only pixels that are less than or greater than the value specified by this parameter.
  • These two params cannot be specified at the same time.
  • In the future, we are considering making it possible to specify also GET - /v1/users/<username>/graphs/<graphID>.html API, but this is not supported at this time.

For more details. please see Pixela API docs.

[Japanese]
GET - /v1/users/<username>/graphs/<graphID> APIが、新たに2つのオプションをサポートしました。

  • lessThan と greaterThan
  • このパラメータで指定した値以下、もしくは値以上の Pixel のみを描画するためのオプションです。
  • これら2つのパラメータは同時に指定することはできません。
  • 将来的には、これらのパラメータを GET - /v1/users/<username>/graphs/<graphID>.html でも利用可能にすることを検討していますが、現時点では対応していません。

詳細はAPIドキュメントを参照してください。