【COZE】EDINET RABBIT（6/29ハッカソン最優秀賞！）
EDINET RABBIT（エディネット ラビット）というCOZE BOTを開発しましたので、その紹介をします。
※当Botが6/29Cozeハッカソンにて最優秀賞を頂きました！当日の写真とデモ動画を掲載します。
※当Botが、Coze June AI Bot Challenge Winners Announcementにて、Most creative botsに選ばれましたので、紹介します。
０．はじめに
・財務諸表は、会社の現在位置を把握できる書類であるため、どの会社もかなりの時間をかけて作成しています。上場企業では、財務諸表を有価証券報告書として公開し、財務データだけでなく、経営方針等、会社にとって重要な情報を経営層と作成し、内容については、監査法人による監査を受けることが必須となっています。
・そうやって作られた有価証券報告書ですが、実際には、ボリュームも大きく（PDF約300ページ、文字数約60万字）、専門用語も多いため、一般の方が読み解くのはなかなか大変だと思います。
・そこで、今回、上場企業の有価証券報告書を掲載しているEDINETの内容を簡単にまとめてくれるBOTを開発しました。このBOTが、多くの方の投資や就職活動、会社側のアカウンタビリティに寄与することを願っています。
１．基本動作
・EDINET RABBITは、EDINETの情報を取得し、分析できるCOZE BOTです。
・EDINETは、金融庁が運営する有価証券報告書等を閲覧できるWebサイトであり、上場企業全ての財務データが掲載されています。
・EDINET RABBITは、会社名と必要な情報を入力するだけで、ユーザーが求める最新の有価証券報告書の情報を提供することができます。
２．応用動作
・財務データを取得した複数の会社については、特定の事項を取り出して比較する表やグラフを作成することができます。
３．EDINET APIの仕組み
・独自開発したプラグイン「EDINET API」（Google App Script：edinet_new_gas_analize）を利用して、EDINETから次の手順で必要なデータを取得しています。
(1)会社名から取得すべき財務データのdocument_idを特定する。
(2)document_idから財務データのcsvを取得し、Google Driveに保存する。
(3)csvデータからユーザーによく使われる部分を特定して、スプレッドシートへコピーする。
(4)EDINET RABBITがスプレッドシートからユーザーの求めるデータを取得して、回答文を作成する（ChatGPT4o）。
※document_idを管理するlistシートは、GASのトリガー機能で、毎日、最新の書類一覧データを自動的に取得します。
＜edinet_new_gas_analize＞
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sh = ss.getSheetByName('list'); // 'list'にデータを入力
function getEDINET() {
var startDate = new Date(); // 開始日
var today = new Date(); // 今日の日付
var dayInMillis = 24 * 60 * 60 * 1000; // 1日のミリ秒
for (var date = startDate; date <= today; date = new Date(date.getTime() + dayInMillis)) {
// 日付をYYYY-MM-DD形式に変換
var formattedDate = Utilities.formatDate(date, "JST", "yyyy-MM-dd");
var url = "https://api.edinet-fsa.go.jp/api/v2/documents.json?date=" + formattedDate + "&type=2&Subscription-Key=＜APIキー＞";
var response = UrlFetchApp.fetch(url);
var json = JSON.parse(response.getContentText());
// 0件なら次の日に進む
var kensu = json.metadata.resultset.count;
if (kensu === 0) {
continue;
}
var item = [
"seqNumber",
"docID",
"edinetCode",
"secCode",
"JCN",
"filerName",
"fundCode",
"ordinanceCode",
"formCode",
"docTypeCode",
"periodStart",
"periodEnd",
"submitDateTime",
"docDescription",
"issuerEdinetCode",
"subjectEdinetCode",
"subsidiaryEdinetCode",
"currentReportReason",
"parentDocID",
"opeDateTime",
"withdrawalStatus",
"docInfoEditStatus",
"disclosureStatus",
"xbrlFlag",
"pdfFlag",
"attachDocFlag",
"englishDocFlag",
"csvFlag",
"legalStatus"
];
var ary = [];
var ary2 = [];
for (var i = 0; i < json.results.length; i++) {
for (var j = 0; j < item.length; j++) {
ary.push(json.results[i][item[j]] || "");
}
ary2.push(ary);
ary = [];
}
// シートに反映
if (ary2.length > 0) {
sh.getRange(sh.getLastRow() + 1, 1, ary2.length, item.length).setValues(ary2);
}
}
}
function downloadUnzipRenameAndClean(docId) {
var url = `https://api.edinet-fsa.go.jp/api/v2/documents/${docId}?type=5&Subscription-Key=＜APIキー＞`;
var outputFolderId = '＜非公開＞';
var tempFolderId = '＜非公開＞';
var outputFolder = DriveApp.getFolderById(outputFolderId);
var tempFolder = DriveApp.getFolderById(tempFolderId);
try {
// ZIPファイルのダウンロード
var response = UrlFetchApp.fetch(url);
var blob = response.getBlob();
// 一時フォルダにZIPファイルを保存
var zipFileName = `${docId}.zip`;
var zipFile = tempFolder.createFile(blob.setName(zipFileName));
// ZIPファイルを解凍
var unzippedFiles = Utilities.unzip(zipFile.getBlob());
var savedFileName;
// 解凍したファイルとフォルダを処理
unzippedFiles.forEach(function(file) {
var fileName = file.getName();
if (fileName.includes('jpcrp')) {
// jpcrpを含むファイルの名称をdocIDに変更して保存
savedFileName = docId + '.' + fileName.split('.').pop(); // 拡張子を保持
outputFolder.createFile(file.setName(savedFileName));
Logger.log('Saved: ' + savedFileName);
}
});
// 一時フォルダの内容をクリア
clearFolder(tempFolder);
Logger.log('Process completed successfully.');
return savedFileName; // 保存したファイル名を返す
} catch (e) {
Logger.log('Error: ' + e.toString());
return null;
}
}
// フォルダの内容をクリアする関数
function clearFolder(folder) {
var files = folder.getFiles();
while (files.hasNext()) {
var file = files.next();
file.setTrashed(true);
}
}
function importCsvToSheet(docID) {
const folderId = '＜非公開＞'; // 格納フォルダのID
const fileName = `${docID}.csv`; // クエリパラメータから取得したdocIDを基にファイル名を設定
// 格納フォルダとCSVファイルを取得
const folder = DriveApp.getFolderById(folderId);
const fileIterator = folder.getFilesByName(fileName);
if (!fileIterator.hasNext()) {
Logger.log('ファイルが見つかりませんでした。');
return null;
}
const file = fileIterator.next();
// ファイルをUTF-16LEとしてデコード
const content = file.getBlob().getDataAsString('UTF-16LE');
// スプレッドシートの操作
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheets = ['work1', 'work2', 'work3', 'work4', 'work5', 'work6', 'work7', 'work8', 'work9'];
let targetSheet;
for (let i = 0; i < sheets.length; i++) {
const sheet = ss.getSheetByName(sheets[i]);
if (sheet.getLastRow() === 0) { // データが無い場合
targetSheet = sheet;
break;
}
}
if (!targetSheet) {
targetSheet = ss.getSheetByName('work1'); // すべてのシートにデータがある場合、work1をクリアして使用
targetSheet.clear();
}
// デコードされた内容をCSVとして解析し、スプレッドシートに張り付ける
const data = Utilities.parseCsv(content, '\t'); // タブ区切りのCSVとして解析
targetSheet.getRange(1, 1, data.length, data[0].length).setValues(data);
// 探すべきA列の内容
const searchKeys = [
'jpcrp_cor:CompanyNameCoverPage',
'jpcrp_cor:CompanyNameInEnglishCoverPage',
'jpcrp_cor:TitleAndNameOfRepresentativeCoverPage',
'jpcrp_cor:AddressOfRegisteredHeadquarterCoverPage',
'jpcrp_cor:jpcrp_cor:PlaceForPublicInspectionCoverPageTextBlock',
'jpcrp_cor:jpdei_cor:EDINETCodeDEI',
'jpcrp_cor:jpcrp_cor:CompanyHistoryTextBlock',
'jpcrp_cor:OverviewOfAffiliatedEntitiesTextBlock',
'jpcrp_cor:InformationAboutEmployeesTextBlock',
'jpcrp_cor:BusinessPolicyBusinessEnvironmentIssuesToAddressEtcTextBlock',
'jpcrp030000-asr_E00369-000:DisclosureOfSustainabilityRelatedFinancialInformationTextBlock',
'jpcrp030000-asr_E00369-000:GovernanceTextBlock',
'jpcrp030000-asr_E00369-000:RiskManagementTextBlock',
'jpcrp030000-asr_E00369-000:StrategyTextBlock',
'jpcrp030000-asr_E00369-000:ReferenceToOtherInformationStrategy',
'jpcrp030000-asr_E00369-000:MetricsAndTargetsTextBlock',
'jpcrp030000-asr_E00369-000:PolicyOnHumanResourceDevelopmentAndImprovementOfInternalEnvironmentStrategyTextBlock',
'jpcrp030000-asr_E00369-000:DescriptionOfMetricsRelatedToPolicyOnHumanResourceDevelopmentAndImprovementOfInternalEnvironmentAndTargetsAndResultsUsingSuchMetricsMetricsAndTargetsTextBlock',
'jpcrp030000-asr_E00369-000:GovernanceClimateChangeTextBlock',
'jpcrp030000-asr_E00369-000:StrategyClimateChangeTextBlock',
'jpcrp030000-asr_E00369-000:RiskManagementClimateChangeTextBlock',
'jpcrp030000-asr_E00369-000:MetricsAndTargetsClimateChangeTextBlock',
'jpcrp_cor:BusinessRisksTextBlock',
'jpcrp_cor:ManagementAnalysisOfFinancialPositionOperatingResultsAndCashFlowsTextBlock',
'jpcrp_cor:CriticalContractsForOperationTextBlock',
'jpcrp_cor:ResearchAndDevelopmentActivitiesTextBlock',
'jpcrp_cor:OverviewOfCapitalExpendituresEtcTextBlock',
'jpcrp_cor:MajorFacilitiesTextBlock',
'jpcrp_cor:PlannedAdditionsRetirementsEtcOfFacilitiesTextBlock',
'jpcrp_cor:OverviewOfCorporateGovernanceTextBlock',
'jpcrp_cor:CorporateGovernanceCompanyWithCorporateAuditorsTextBlock',
'jpcrp_cor:BasicPolicyRegardingControlOfCompanyTextBlock',
'jpcrp_cor:ManagementAnalysisOfFinancialPositionOperatingResultsAndCashFlowsTextBlock',
'jpcrp_cor:NameOfFinancialInstrumentsExchangeOnWhichSecuritiesAreListedOrAuthorizedFinancialInstrumentsBusinessAssociationToWhichSecuritiesAreRegistered',
'jpcrp_cor:InformationAboutOfficersTextBlock',
'jpcrp_cor:FiscalYearCoverPage',
'jpcrp_cor:AverageAnnualSalaryInformationAboutReportingCompanyInformationAboutEmployees',
'jpcrp_cor:NumberOfEmployees',
'jpcrp_cor:DescriptionOfBusinessTextBlock'
];
const additionalKeys = [
'jpcrp_cor:NetSalesSummaryOfBusinessResults',
'jpcrp_cor:OrdinaryIncomeLossSummaryOfBusinessResults',
'jpcrp_cor:ProfitLossAttributableToOwnersOfParentSummaryOfBusinessResults',
'jpcrp_cor:ComprehensiveIncomeSummaryOfBusinessResults',
'jpcrp_cor:NetAssetsSummaryOfBusinessResults',
'jpcrp_cor:TotalAssetsSummaryOfBusinessResults',
'jpcrp_cor:NetAssetsPerShareSummaryOfBusinessResults',
'jpcrp_cor:BasicEarningsLossPerShareSummaryOfBusinessResults',
'jpcrp_cor:DilutedEarningsPerShareSummaryOfBusinessResults',
'jpcrp_cor:EquityToAssetRatioSummaryOfBusinessResults',
'jpcrp_cor:RateOfReturnOnEquitySummaryOfBusinessResults',
'jpcrp_cor:PriceEarningsRatioSummaryOfBusinessResults'
];
// A列およびC列を取得
const columnA = targetSheet.getRange(1, 1, targetSheet.getLastRow(), 1).getValues().flat();
const columnC = targetSheet.getRange(1, 3, targetSheet.getLastRow(), 1).getValues().flat();
// 対象行を探し、見つけた行をリストに格納
const rowsToInsert = [];
for (let i = 0; i < columnA.length; i++) {
if (searchKeys.includes(columnA[i])) {
if (columnA[i] === 'jpcrp_cor:NumberOfEmployees') {
if (columnC[i] === 'CurrentYearInstant') {
// A列が'jpcrp_cor:NumberOfEmployees'でC列が'CurrentYearInstant'の行
const rowData = targetSheet.getRange(i + 1, 1, 1, targetSheet.getLastColumn()).getValues();
rowsToInsert.push(rowData[0]);
}
} else {
// その他の行
const rowData = targetSheet.getRange(i + 1, 1, 1, targetSheet.getLastColumn()).getValues();
rowsToInsert.push(rowData[0]);
}
}
}
// 追加の用語がA列に含まれ、C列に「Current」を含む行をリストに追加
for (let i = 0; i < columnA.length; i++) {
if (additionalKeys.includes(columnA[i]) && columnC[i].includes('Current')) {
const rowData = targetSheet.getRange(i + 1, 1, 1, targetSheet.getLastColumn()).getValues();
rowsToInsert.push(rowData[0]);
}
}
// 2行目以降のデータを削除
const lastRow = targetSheet.getLastRow();
if (lastRow > 1) {
targetSheet.deleteRows(2, lastRow - 1);
}
// 2行目以降にデータを挿入
if (rowsToInsert.length > 0) {
targetSheet.insertRowsAfter(1, rowsToInsert.length); // 2行目以降に行を挿入
targetSheet.getRange(2, 1, rowsToInsert.length, rowsToInsert[0].length).setValues(rowsToInsert);
}
return targetSheet.getName(); // 張り付けしたシート名を返す
}
function doGet(e) {
var docID = e.parameter.docID; // クエリパラメータからdocIDを取得
var keyword = e.parameter.companyName; // クエリパラメータからcompanyNameを取得
var koumoku = e.parameter.koumoku; // クエリパラメータからkoumokuを取得
if (keyword && keyword.toLowerCase() === 'deletesheets') {
deleteSheetsData();
return ContentService.createTextOutput(JSON.stringify({ status: "All sheets data deleted." }))
.setMimeType(ContentService.MimeType.JSON);
}
if (docID && koumoku) {
downloadUnzipRenameAndClean(docID); // docIDに基づいてファイルをダウンロードして処理
var sheetName = importCsvToSheet(docID); // CSVをスプレッドシートにインポートする関数を呼び出し
if (!sheetName) {
return ContentService.createTextOutput(JSON.stringify({ error: "ファイルが見つかりませんでした。" }))
.setMimeType(ContentService.MimeType.JSON);
}
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName(sheetName); // データが保存されているシートを取得
var fullRange = sheet.getDataRange(); // シート全体のデータ
var fullValues = fullRange.getValues();
// B列をkoumokuで検索して、当該用語を含むデータを抽出
var filteredValues = fullValues.filter(row => row[1].toString().includes(koumoku));
return ContentService.createTextOutput(JSON.stringify(filteredValues))
.setMimeType(ContentService.MimeType.JSON);
} else if (docID) {
downloadUnzipRenameAndClean(docID); // docIDに基づいてファイルをダウンロードして処理
var sheetName = importCsvToSheet(docID); // CSVをスプレッドシートにインポートする関数を呼び出し
if (!sheetName) {
return ContentService.createTextOutput(JSON.stringify({ error: "ファイルが見つかりませんでした。" }))
.setMimeType(ContentService.MimeType.JSON);
}
// JSONオブジェクト形式で"ok"とシート名を返す
var jsonObject = {
"status": "ok",
"status_code": 200,
"sheet_name": sheetName,
"action_id": "＜非公開＞"
};
return ContentService.createTextOutput(JSON.stringify(jsonObject))
.setMimeType(ContentService.MimeType.JSON);
} else if (keyword) {
var ss = SpreadsheetApp.openById('＜非公開＞');
var sheet = ss.getSheetByName('list'); // シート名でシートを取得
var dataRange = sheet.getDataRange();
var values = dataRange.getValues();
var filteredValues = values.filter(row => row[7] == 10 && row[9] == 120); // H列が10、J列が120の行を絞り込む
var matchingRow = filteredValues.find(row => row[5] && row[5].toString().toLowerCase().includes(keyword.toLowerCase()));
if (matchingRow) {
var jsonObject = {
id: matchingRow[0],
document_id: matchingRow[1],
company_code: matchingRow[2],
empty_field1: matchingRow[3],
jcn: matchingRow[4],
company_name: matchingRow[5],
empty_field2: matchingRow[6],
type_code: matchingRow[7],
value1: matchingRow[8],
value2: matchingRow[9],
start_date: matchingRow[10],
end_date: matchingRow[11],
submit_date: matchingRow[12],
document_description: matchingRow[13]
};
return ContentService.createTextOutput(JSON.stringify(jsonObject))
.setMimeType(ContentService.MimeType.JSON);
} else {
return ContentService.createTextOutput(JSON.stringify({ error: "キーワードにマッチする企業名が見つかりませんでした。" }))
.setMimeType(ContentService.MimeType.JSON);
}
} else {
return ContentService.createTextOutput(JSON.stringify({ error: "docIDまたはキーワードを指定してください。" }))
.setMimeType(ContentService.MimeType.JSON);
}
}
function deleteSheetsData() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheets = ['work1', 'work2', 'work3', 'work4', 'work5', 'work6', 'work7', 'work8', 'work9'];
sheets.forEach(function(sheetName) {
var sheet = ss.getSheetByName(sheetName);
if (sheet) {
var lastRow = sheet.getLastRow();
if (lastRow > 0) {
sheet.getRange(1, 1, lastRow, sheet.getLastColumn()).clearContent(); // すべてのデータをクリア
}
}
});
}
function findSpreadsheetById(driveId, docID) {
var folder = DriveApp.getFolderById(driveId);
var files = folder.getFilesByName(docID);
while (files.hasNext()) {
var file = files.next();
if (file.getMimeType() === MimeType.GOOGLE_SHEETS) {
return file;
}
}
return null;
}
４．その他
・このCOZE BOTは、プラグインにEDINET API、Google Sheets、Code Interpriter、Google Web Searchを利用しています。
・EDINET APIでは、GASであるedinet_new_gas_analizeに接続し、書類一覧API、書類取得APIから財務データを取得しています。
・書類取得APIで取得する会社の有価証券報告書データは膨大であり、そのままの状態では、ChatGPT4oであってもユーザーに対し適切な回答部分を特定することができません。
・このため、有価証券報告書を読み解き、ユーザーによく使われる部分のみをコピーできるGASを設計しました。更に詳細なデータが欲しい方は、WebでEDINETへ直接アクセスすることをおすすめします。
・スプレッドシートでは、9社までの財務データを保持しておくことが可能です。
・この仕組みを利用することで、EDINET RABBITは企業の正確な財務情報を速やかに提供することが可能となります。
・このCOZE BOTは、Cozeハッカソンに応募しています（最優秀賞を頂きました！ありがとうございました！）。
この記事が気に入ったらサポートをしてみませんか？